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在 SAP NetWeaver 出 现 之 前 的 30 多 年 中 ，SAP 一 直 在 努力 使 自家 的 企业 管理 软件 
(ERP) 产品 尽善尽美 ， 从 R/2 到 R/3 再 到 ECC，SAP 的 核心 产品 在 不 断 地 成 熟 与 赔 变 ， 然 
而 SAP 的 开发 技术 却 始 终局 限于 ABAP 语言 (Advanced Business Application Programming ) , 
产品 也 始终 以 C/S 架构 存在 。SAP NetWeaver 平台 的 出 现 是 SAP 为 了 适应 互联 网 世界 的 发 展 
做 出 的 一 次 大 胆 改 革 ， 随 之 带 来 的 还 有 全 新 的 Web Dynpro 技术 。 

在 SAP 传统 ERP 软件 中 的 屏幕 开发 技术 称 为 “Dynpro” 技 术 ， 在 决定 向 互联 网 敞开 怀 
抱 后 ， 新 的 技术 更 直接 地 被 定义 为 了 “Web Dynpro”, 使 用 Web Dynpro 开发 的 应 用 程序 ， 
都 需要 通过 浏览 带 访问 ， 简 化 了 安装 客户 端 和 熟悉 系统 的 过 程 。SAP 的 Web Dynpro 同时 文 
持 ABAP 语言 和 Java Was 本 书 将 着 重 介 绍 Web Dynpro for Java (WD4J) 技术 的 相关 内 容 。 

从 内 容 上 来 看 ， 可 以 将 本 书 分 为 两 部 分 ， 前 半 部 分 主要 介绍 Web Dynpro for Java 的 技术 
细节 以 及 相关 开发 实例 ， 后 半 部 分 则 介绍 与 WD4J 技术 相关 的 开发 内 容 。Web Dynpro 背 靠 
着 强大 的 SAP NetWeaver 平台 ， 提 供 了 包括 版 本 管理 、 质 量 控制 、 运 行 监控 以 及 性 能 优化 在 
内 的 一 系列 服务 和 功能 ， 而 NetWeaver 平台 则 依托 的 是 整个 SAP ERP 的 大 生态 圈 ， 这 是 Web 
Dynpro 语言 拥有 的 无 与 伦比 的 优势 。 

本 书 各 章 的 内 容 安排 如 下 。 

第 1 章 : 介绍 SAP NetWeaver 架构 和 SAP NetWeaver 开发 者 工作 室 ， 一 方面 了 解 Web 
Dynpro 强大 的 平台 优势 ， 另 一 方面 熟悉 开发 环境 ， 为 学 习 Web Dynpro 技术 打下 基础 。 

第 2 章 : 遵循 学 习 开 发 语言 的 惯例 ， 先 用 Web Dynpro 来 完成 一 个 “Hello world” 的 应 
用 程序 ， 从 实战 开发 开始 了 解 Web Dynpro 开发 过 程 。 

第 3 章 : 对 WD4J 技术 进行 分 析 和 讲解 ， 包 括 视 图 、 窗 口 、 组 件 控制 器 、 消 息 池 、 组 件 
和 模型 等 内 容 。 除 了 对 开发 技术 的 理论 介绍 外 ， 基 本 上 每 一 部 分 内 容 都 会 包含 对 应 的 开发 实 
例 ， 以 方便 大 家 理论 与 实施 相 结合 。 

第 4 章 : 重点 介绍 Web Dynpro 的 页 面 元 素 。 由 于 Web Dynpro 的 一 项 优势 在 于 标准 化 的 
图 形 开发 并 且 提供 了 丰富 的 元 素 给 顾问 选择 ， 因 此 本 章 将 对 常用 的 一 些 元 素 进行 介绍 ， 并 同 
样 地 包含 了 具体 使 用 案例 的 讲解 。 

第 5 章 : 在 熟悉 了 WD4J 开发 技术 以 后 ， 本 章 模拟 一 部 分 在 实际 项 目 开发 中 的 场景 。 

第 6 章 : 介绍 SAP NetWeaver 平台 的 企业 门户 ，SAP 将 其 定位 成 整个 平台 的 统一 入 口 ， 
同时 它 也 是 通过 基于 角色 的 用 户 访问 Web Dynpro 应 用 程序 时 所 使 用 的 系统 。 

第 7 章 : 具体 介绍 SAP 的 业务 流程 管理 ， 通 过 SAP NetWeaver 平台 可 以 实现 不 同系 统 间 
业务 的 串联 ， 大 大 提升 了 用 户 的 工作 效率 。 当 然 ， 业 务 流程 的 界面 开发 使 用 的 就 是 Web 
Dynpro for Java 技术 。 

第 8 章 : 在 介绍 了 Web Dynpro 的 应 用 系统 企业 门户 以 及 最 新 产品 业务 流程 管理 后 ， 不 
得 不 提 到 Web Dynpro 背后 的 NWA 管理 者 平台 ， 它 凭借 强大 功能 为 Web Dynpro 保驾 护航 。 
另外 ,还 介绍 了 其 他 一 些 基 于 NWA 进行 配置 管理 的 开发 技术 ， 包 括 了 作业 的 配置 和 开发 、 
Adobe 交互 表单 开发 、 自 定义 数据 源 使 用 、 全 局 变量 应 用 以 及 日 志 管 理 等 内 容 。 
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第 9 章 : 在 大 型 的 开发 团队 中 ，SAP NetWeaver 开发 者 架构 也 是 开发 团队 进行 代码 管理 
的 一 个 必要 工具 ， 它 继承 了 需要 ABAP 开发 和 程序 管理 中 的 优秀 特点 ， 帮 助 WDA 的 开发 人 
员 能 够 高 效 地 完成 各 自 的 开发 任务 。 

本 书 1 ~7 章 主 要 由 俞 陈雷 编写 ， 赵 旭 和 周 世 胜 参 与 了 编写 ; 第 8 和 9 章 由 周 世 胜 编写 ; 
书 中 涉及 的 Web Dynpro 开发 实例 均 由 赵 旭 设计 开发 并 完成 记录 ， 俞 陈 霄 和 周 世 胜 参与 测试 
和 校 验 。 另 外 ， 还 要 感谢 思 普 艾 斯 提供 的 系统 环境 文 持 以 及 其 他 技术 服务 支持 。 

由 于 编者 水 平 有 限 ， 书 中 难免 存在 不 足 之 处 ， 望 广大 读者 批评 指正 1 
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S512 SAP NetWeaver 架构 与 开发 者 工作 室 


Web Dynpro for Java (简称 WD4J) 开发 技术 的 优势 在 于 拥有 SAP NetWeaver 平台 以 及 
NetWeaver 开发 者 工作 室 ， 前 者 是 WD4J 的 坚实 后 盾 ， 而 后 者 则 是 WD BEF ARRAY Fl I 
本 章 将 对 它们 进行 介绍 ， 为 之 后 的 Web Dynpro 开发 做 好 准备 。 


1.1 SAP NetWeaver 架构 


SAP 公司 专注 于 ERP (Enterprise Resources Planning， 企 业 资源 计划 ) 软件 数 十 年 ， 随 
着 不 断 进 行 需求 延伸 以 及 功能 拓展 ， 它 在 传统 的 ERP 软件 产品 外 还 研发 了 客户 关系 管理 系 
统 (Customer Relationship Management，CRM) 、 供 应 链 管理 系统 (Supply Chain Management, 
SCM) 、 供 应 商 关 系 管理 系统 (Supplier Relationship Management, SRM) 和 产品 生命 周期 管 
理 系 统 (Product Lifecycle Management, PLM) 等 产品 ， 以 及 与 之 相关 的 诸多 行业 的 成 熟 解 
决 方案 。 然 而 ，SAP 不 仅 向 客户 提供 了 成 熟 的 业务 应 用 程序 或 系统 ,在 每 一 代 SAP RAE 
装 软件 中 还 提供 了 与 之 相 匹配 的 工具 、 框 架 及 服务 以 支持 在 此 基础 上 的 开发 和 配置 工作 ， 
SAP NetWeaver 正 是 这 一 代 产 品 的 基础 。 

除了 为 相关 SAP 产品 提供 框架 服务 和 支持 以 外 ，SAP NetWeaver 本 身 还 是 一 个 集成 化 的 
平台 ， 提 供 了 传统 ERP 无 法 完成 的 集成 和 整合 功能 。 通 过 SAP NetWeaver 的 架构 图 ， 就 能 
到 SAP 为 了 从 各 个 层面 对 业务 、 数 据 甚至 流程 进行 集成 而 做 的 努力 ， 如 图 1-1 所 示 。 
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图 1-1 SAP NetWeaver 架构 图 


SAP NetWeaver 应 用 平台 同时 支持 JavaEE 架构 和 ABAP 架构 ， 针 对 套装 软件 中 的 不 同 产 
品 也 需要 选择 不 同类 型 的 应 用 服务 需 ( Application Server, AS) 安装 ， 这 样 既 保留 了 SAP 传 
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统 的 技术 特点 ， 又 逐步 地 向 JavaEE 的 方向 靠拢 。 图 1-1 中 上 方 的 3 个 集成 层 分 别 代表 了 
“人 员 集 成 ” “信息 集成 ”和 “流程 集成 ”， 所 有 集成 应 用 都 建立 在 底层 的 应 用 平台 之 上 。 
需要 注意 的 是 ， 这 样 的 SAP NetWeaver 组 件 架 构 并 非 表 示 几 个 集成 层面 有 着 继承 关系 ， 事 实 
上 每 一 层 的 集成 应 用 都 是 相对 独立 的 ， 而 所 有 的 组 件 可 以 组 合 在 一 起 提供 完善 的 功能 和 
服务 。 


1.1.1 人 员 集 成 


在 SAP NetWeaver 的 架构 中 ， 人 员 集 成 包含 了 多 渠道 访问 、 门 户 和 协作 等 内 容 ， 这 些 内 
容 都 有 一 个 相同 的 前 提 条 件 ， 就 是 所 有 系统 用 户 都 拥有 一 套 标准 化 的 基于 角色 设计 的 访问 方 
st, 并且 用 户 可 以 通过 不 同 的 方式 进行 访问 ， 如 移动 端 或 是 个 人 计算 机 端 。 而 企业 门户 则 将 
所 有 的 业务 系统 入 口 进行 集中 ， 并 且 通 过 相关 的 配置 实现 用 户 的 单 点 登录 (Single Sign - on， 
SSO), ， 即 用 户 只 需要 进行 一 次 登录 动作 就 可 以 访问 所 有 的 相关 系统 。 在 传统 的 企业 信息 化 
系统 大 环境 中 ， 用 户 需 要 登录 若干 不 同 的 系统 进行 相关 业务 的 处 理 。 例 如 ， 一 位 部 门 经 理 需 
要 登录 到 人 力 资 源 管 理 系 统 来 访问 所 有 的 人 事 相 关 信 息 ， 包 括 人 员 报 表 、 薪 酬 统计 、 绩 效 考 
核 等 内 容 ， 接 下 来 又 需要 登录 对 应 的 财务 系统 对 部 门 的 财务 状况 进行 汇总 分 析 ， 可 能 还 需要 
登录 另 一 个 仓储 管理 系统 来 查看 和 审核 相关 的 仓储 调配 。SAP 企业 门户 的 任务 就 是 将 这 些 人 
口 统 一 起 来 , 这 样 用 户 不 再 需要 了 解 每 个 系统 的 具体 情况 、 登 录 方 式 或 界面 操作 ， 只 需要 
登录 企业 门户 ， 就 可 以 通过 菜单 和 链接 在 系统 内 进行 查看 和 处 理 所 有 相关 系统 的 各 项 
业务 。 

与 用 户 在 企业 中 的 位 置 一 样 ， 门 户 集成 也 同样 基于 角色 的 概念 ， 因 为 每 个 用 户 都 在 企业 
中 有 相应 的 岗位 和 角色 ， 如 系统 管理 员 、 部 门 经 理 、 采 购 员 或 销售 员 。 门 户 中 的 每 个 角色 都 
包含 了 对 应 岗位 的 所 有 的 功能 以 及 信息 ， 且 可 以 灵活 地 进行 组 合 和 拆 分 ， 方 便 应 对 不 同 企 业 
的 业务 状况 。 面 对 不 同类 型 的 系统 ， 门 户 同样 提供 了 丰富 的 框架 和 服务 ， 用 于 支持 不 同类 型 
的 页 面 ， 这 其 中 不 仅 包含 简单 的 HTML 网 页 ， 还 包括 了 Web Dynpro 开发 的 应 用 程序 、 数 据 
CERK., KRIE, SAP GUI 界面 以 及 Adobe 交互 式 表单 等 类 型 。 

在 传统 ERP 软件 中 ， 产 品 提供 了 不 同 的 功能 ， 用 户 在 操作 对 应 业务 时 需要 首先 访问 不 
同 的 功能 ， 然 后 才能 在 功能 页 面 中 操作 与 自己 业务 相关 的 内 容 (如 ECC 系统 中 的 事务 代 
码 ) 。 相 对 地 ， 门 户 在 整合 了 复杂 的 页 面 后 ， 一 方面 提供 了 页 面 和 多 样 化 的 布局 对 页 面 进行 
整合 ， 以 便 对 这 些 页 面 进行 组 合 或 者 分 类 ; 另 一 方面 ， 门 户 还 提供 了 工作 集 和 角色 用 于 构建 
复杂 的 目录 层次 ， 最 终 每 个 用 户 都 会 根据 分 配 的 角色 内 容 看 到 各 自 对 应 的 导航 目录 以 及 页 面 
内 容 。 个 性 化 定制 的 页 面 可 以 最 大 限度 地 提升 用 户 的 参与 度 ， 并 降低 学 习 和 培训 难度 。 

在 人 员 集 成 层 的 协作 其 实 是 与 信息 集成 层 的 知识 管理 紧密 相连 的 ， 且 这 两 个 组 件 都 通过 
SAP 企业 门户 提供 相应 的 功能 和 服务 。 这 是 因为 在 企业 中 ， 不 仅 拥 有 海量 的 结构 化 数据 ， 还 
有 大 量 的 非 结构 化 数据 ， 如 各 种 各 样 的 文档 、 图 片 或 者 邮件 存档 等 内 容 ， 这 些 需 要 通过 系统 
进行 管理 和 访问 。 通 过 数据 仓库 的 管理 ,结构 化 的 数据 已 经 可 以 通过 门户 的 应 用 程序 进行 读 
取 和 展现 或 者 通过 数据 仓库 的 报表 进行 浏览 ， 所 以 非 结构 化 数据 在 门户 中 的 访问 和 使 用 也 就 
变 得 十 分 必要 了 。 知 识 管理 并 非 仅仅 是 一 个 文档 管理 的 工具 ， 它 同时 还 具有 内 容 管理 的 功 
能 ， 配 合 门 户 中 的 搜索 引擎 ， 可 以 使 用 户 方便 、 迅 速 地 定位 到 想 要 查找 的 文档 和 内 容 。 

因为 文档 的 主要 功能 是 用 于 交换 信息 ， 所 以 用 户 经 常 需要 访问 一 些 共享 文档 ,为 了 这 样 
的 业务 需求 ，SAP 同样 在 门户 中 提供 了 许多 与 协作 相关 的 功能 和 服务 。 所 有 用 户 的 交流 发 生 
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在 门户 的 协作 工作 室 中 ， 类 似 网 络 上 的 论坛 。 从 技术 角度 来 看 ， 每 个 工作 室 其 实 是 一 个 文档 
容 需 ， 同 时 也 可 以 集成 很 多 与 信息 项 目 管理 相关 的 内 容 ， 如 日 志 、 任 务 清 单 等 内 容 。 

所 有 这 些 功能 和 服务 都 努力 地 将 企业 用 户 在 使 用 ERP 软件 以 及 ERP 相关 的 周边 产品 时 
集中 到 了 一 起 ， 也 为 企业 以 及 企业 中 的 每 个 用 户 进行 业务 操作 、 报 表 查 询 以 及 流程 处 理 带 来 
了 许多 便利 。 


1.1.2 信息 集成 


在 SAP 的 产品 之 中 ， 除 了 ABAP 架构 的 ERP 产品 之 外 ， 数 据 仓 库 (后 来 逐渐 进化 成 了 
商务 智能 系统 ) 是 SAP NetWeaver 中 最 成 熟 稳 定 的 组 件 。 数 据 仓库 的 作用 是 什么 呢 ?” 打 个 比 
方 ， 企 业 的 主 数据 形成 了 企业 的 上 骨架， 而 其 他 的 业务 数据 则 构成 了 企业 的 肌肉 ， 通 过 业务 数 
据 分 析 可 以 了 解 到 潜在 客户 和 潜在 的 市 场 ， 可 以 优化 企业 的 物资 分 配 和 库存 ， 还 可 以 帮助 企 
业 更 有 选择 性 地 进行 采购 并 控制 成 本 。 数 据 仓库 的 作用 就 是 用 于 管理 除 主 数 据 、 非 结构 化 数 
据 之 外 的 所 有 商务 内 容 。 

在 最 初 的 阶段 ， 企 业 的 业务 数据 往往 分 布 在 若干 不 同 的 业务 系统 中 ,所 以 SAP 开始 构 
建 一 个 数据 仓库 ， 它 的 数据 并 不 是 由 业务 员 手 工 录入 的 ， 而 是 从 其 他 相关 的 业务 系统 中 抽取 
并 整合 在 一 起 的 。 为 了 使 这 个 数据 仓库 对 于 所 有 业务 数据 的 分 析 和 评估 尽 可 能 地 灵活 和 全 
面 ， 并 且 尽 可 能 地 优化 数据 读 取 和 展现 的 性 能 ， 最 终 SAP 决定 从 OLTP (Online Transaction 
Processing ， 联 机 事务 处 理 ) 的 系统 中 抽取 数据 ， 并 经 过 SAP 数据 仓库 的 处 理 存放 在 适用 于 
OLAP (Online Analytical Processing， 联 机 分 析 处 理 ) 应 用 程序 的 数据 结构 中 。 在 后 来 的 发 展 
过 程 中 ， 为 了 优化 报表 展示 的 效果 ，SAP 收购 了 Business Object 产品 ， 并 将 其 与 数据 仓库 进 
行 了 深度 的 融合 。 

在 信息 集成 层 ， 除 了 数据 仓库 之 外 ， 主 数据 管理 是 SAP 后 来 添加 到 SAP NetWeaver 的 一 
个 组 件 。 它 主要 用 于 管理 企业 系统 间 的 共享 数据 ， 包 括 客户 、 供 应 商 、 账 户 和 组 织 部 门 相关 
数据 等 内 容 。 由 于 强大 的 SAP NetWeaver 平台 支持 ， 主 数据 管理 系统 也 支持 不 同 的 技术 框架 
和 接口 类 型 ， 用 于 和 其 他 业务 系统 进行 数据 集成 ， 同 时 它 也 支持 Web Dynpro 技术 的 应 用 程 
序 或 接口 的 开发 。 


1.1.3 流程 集成 


流程 集成 主要 针对 的 是 跨 业 务 系统 流程 的 串联 和 整合 ， 而 并 不 仪 仪 针 对 需要 审批 和 推送 
待 办 任务 的 流程 管理 ， 所 以 在 SAP NetWeaver 平台 中 流程 集成 对 应 了 两 个 重要 的 产品 和 内 
容 : SAP ZMA (Exchange Infrastructure, XI) 以 及 业务 流程 管理 系统 。 其 中 SAP 交换 架 
构 后 来 升级 并 直接 改名 为 流程 集成 系统 (Process Integration, PI) 。 

流程 集成 系统 的 作用 主要 是 用 于 同步 和 异步 消息 的 交换 ， 并 且 帮 助 SAP 相关 系统 与 非 
SAP 系统 的 数据 交互 ， 最 终 将 原本 复杂 的 网 状 业 务 系统 互联 场景 检 换 为 更 为 简洁 的 星 形 染 
构 ， 即 所 有 的 系统 数据 、 消 息 都 面向 PI 进行 发 送 ， 并 由 PI 系统 统一 进行 转发 。PI 系统 针对 
不 同类 型 的 接口 提供 了 多 样 化 的 适配器 进行 连接 ， 同 时 也 规范 了 所 有 外 围 业 务 系统 的 接口 定 
义 和 数 据 传 输 。 由 于 SAP NetWeaver 平台 的 支持 ，PI 系统 也 有 完整 的 数据 传输 记录 和 日 志 查 
询 功 能 ， 提 高 了 业务 数据 传输 的 安全 性 和 可 靠 性 。 

PI 系统 本 身 只 能 处 理 简 单 的 流程 ， 在 实际 业务 场景 中 ， 更 多 的 是 对 周边 多 样 化 的 业务 
系统 数据 和 接口 进行 统一 ， 或 是 将 多 个 系统 的 业务 数据 集中 到 一 个 系统 中 ,方便 业务 人 员 进 

了 


行 处 理 。 而 相对 地 ， 业 务 流 程 管理 系统 (Business Process Management, BPM) 则 是 将 不 同系 
统 的 数据 集中 进行 处 理 和 审核 ， 并 实时 推送 待 办 任务 的 一 个 流程 管理 系统 。 如 果 说 门户 系统 
方便 了 用 户 查看 报表 ， 处 理 单一 任务 ， 那 BPM 的 流程 管理 则 帮助 用 户 将 不 同业 务 系统 的 处 
理 逻 辑 集中 到 了 一 起 ， 在 审批 过 程 中 支持 会 签 、 委 派 等 功能 ， 在 流程 流转 过 程 中 还 具备 了 完 
善 的 监控 系统 ， 提 供 了 完整 的 系统 运行 日 志 ， 保 证 业务 流程 顺利 运行 。 


1.1.4 Web Dynpro 技术 


在 SAP NetWeaver 的 众多 组 件 中 ， 基 于 Java AS 运行 的 应 用 程序 、 服 务 、 功 能 和 系统 
大 多 是 通过 Web Dynpro for Java 技术 实现 的 前 端 页 面 。 在 传统 的 ERP 软件 中 ， 所 有 的 界面 
都 是 以 功能 为 导向 进行 开发 。 例 如 ， 界 面 A 可 以 完成 功能 1 和 2， 而 界面 B 可 以 完成 功能 
3， 用 户 为 了 完成 不 同 的 功能 ， 需 要 主动 地 访问 对 应 的 功能 页 面 (也 就 是 SAP ECC 中 事务 
代码 的 概念 ) ， 同 时 ABAP 语言 的 开发 也 需要 学 习 和 培训 才能 了 解 用 户 界 面 的 组 成 和 使 
用 。 然 而 在 以 Java 应 用 服务 器 为 基础 的 系统 中 ， 所 有 界面 元 素 开 发 都 通过 Web Dynpro 的 
图 形 化 界面 进行 展现 ， 即 使 是 不 了 解 任何 开发 语言 的 业务 人 员 ， 也 能 对 界面 提出 相应 的 
要 求 ， 达 到 所 见 即 所 得 的 效果 。 另 外 ，Web Dynpro 开发 的 应 用 程序 通过 页 面 集成 方式 添 
加 至 门户 中 ， 并 以 面向 角色 的 方式 添加 给 不 同 的 用 户 或 用 户 组 ， 使 得 用 户 在 登录 系统 后 
就 能 看 到 对 应 角色 或 者 是 对 应 权限 所 能 使 用 的 所 有 功能 ， 这 为 传统 的 ERP 用 户 带 来 了 全 
新 的 体验 。 


1.2 SAP NetWeaver 开发 者 工作 室 


在 介绍 Web Dynpro for Java 的 集成 开发 环境 (Integrated Development Environment, IDE) 
之 前 ， 首 先 来 比较 一 下 ABAP 工作 台 与 传统 Java 开发 IDE 的 区 别 。 
ABAP 工作 台 的 特点 如 下 : 
© ABAP 工作 人 台 的 开发 是 面向 服务 器 端的 。 
© 所 有 的 设计 开发 工具 都 可 以 通过 整个 开发 框架 (事务 代码 SE80) 来 实现 。 
。 包含 编译 、 发 布 以 及 版 本 管理 的 完善 的 基础 架构 与 ABAP THE GCSES TAIN SCHR 
大 规模 协作 开发 。 
© 文 持 SAP 相关 的 技术 标准 ， 包 括 远程 功能 模块 调用 、BAPI 接口 公开 以 及 ERP 系统 内 
各 种 形式 开发 等 技术 内 容 。 
传统 Java IDE 的 特点 如 下 : 
© Java IDE 的 开发 是 在 本 地 进行 的 ,在 搭建 对 应 的 环境 后 ， 开 发 工具 还 实现 了 标签 高 
亮 、 关 键 字 自动 完成 以 及 本 地 编译 等 功能 。 
e 可 以 搭配 本 地 的 运行 环境 搭建 独立 的 测试 环境 。 
o 支持 一 些 开 放 的 技术 标准 ， 如 JPSE、J2EFE、HTML、XML 等 技术 。 
在 两 者 开发 环境 比较 之 后 ，SAP 决定 在 WD 的 开发 工具 中 将 两 种 开发 手段 的 优势 集中 
到 一 起 ， 它 将 会 满足 : 
© 为 所 有 开发 设计 工具 提供 统一 的 框架 ， 并 同时 集成 所 有 的 开发 架构 组 件 。 
© 为 大 规模 开发 的 团队 提供 便利 的 集成 性 架构 ， 提 供 统一 的 编译 运行 环境 以 及 版 本 


管理 。 


© 提供 本 地 化 开发 的 支持 ， 包 括 代 码 关键 字 自 动 完 成 以 及 本 地 编译 等 工作 。 

© 优化 支持 开发 的 技术 标准 以 及 SAP 的 相关 技术 标准 。 

© 支持 多 样 化 的 工程 创建 和 编译 ， 支 持 所 有 与 SAP NetWeaver 相关 开发 对 象 的 设计 。 

e 对 于 用 户 界面 开发 ， 使 用 图 形 化 方式 进行 编辑 。 

最 终 SAP 完成 了 为 WD4J 开发 撤 术 及 相关 内 容 开 发 的 IDE “SAP NetWeaver 开发 者 工作 
Z” (SAP NetWeaver Developer Studio, SAP NWDS) 的 框架 搭建 。 其 中 基础 平台 和 J2SE T 
具 集 部 分 都 是 基于 开源 的 Eclipse 平台 ， 而 为 了 满足 SAP 对 于 ABAP 开发 优势 的 迁移 ， 额 外 
增加 了 许多 组 件 ， 包 括 应 用 模型 生成 器 、 视 图 设计 器 、jJava FHE, JEE 工具 集 ， 以 及 新 增 
的 抽象 层 模型 和 SAP 服务 层 的 功能 文 持 。 开 发 者 工作 室 架 构图 如 图 1-2 所 示 。 


Ey Ey | BE || Sr” 


应 用 模型 视图 Java J2EE 
生成 器 设计 器 字典 工具 集 


eee smse | SIE 


Eclipse 平台 和 运行 环境 řec | p se 


图 1-2 开发 者 工作 室 架 构图 


1.2.1 工作 室 架 构 


下 面具 体 介 绍 NWDS 的 体系 架构 。 

作为 NWDS 的 核心 内 容 ，Eclipse 平台 是 整个 IDE 的 基础 ， 它 控制 着 IDE 的 核心 功能 ， 
同时 也 提供 一 个 强大 的 架构 ， 以 支持 在 此 平台 上 的 服务 扩展 和 功能 延伸 。 具 体 来 说 ,一方 
面 ， 由 于 Eclipse 本 身 与 Java 语言 的 紧密 联系 ， 软 件 对 于 本 地 Java 开发 所 拥有 的 优点 都 同样 
地 呈现 在 WD4) 的 代码 开发 中 ; 另 一 方面 ， 由 于 它 允 许 不 同 软件 厂商 或 开发 技术 以 一 定 的 标 
准 对 平台 功能 进行 扩展 ， 在 集成 SAP NetWeaver 相关 的 一 些 工具 集 和 服务 之 后 ，NWDS 已 经 
可 以 支持 几乎 所 有 的 NetWeaver 平台 开发 类 型 和 内 容 (如 Java、C、JSP、HTML、XML 等 )， 
并 且 相 关 的 功能 (如 创建 EJB， 作 业 ，Web 服务 等 ) 在 使 用 时 也 与 Eclipse 原本 的 平台 无 颖 
集成 。 

对 于 平台 的 拓展 性 ， 新 的 功能 和 工具 集 都 在 基于 Eclipse 的 “Plug - in” 技 术 标 准 上 进 
行 集成 ， 每 一 个 插件 都 可 以 作为 一 个 单独 的 功能 进行 开发 、 拓 展 并 集成 至 Eclipse 平台 中 ， 
较为 复杂 的 功能 也 可 以 通过 多 个 插件 组 合 实现 。 从 某 种 程度 而 言 ，Eclipse 平台 本 身 即 是 由 
若干 大 大 小 小 的 插件 组 合 而 成 的 ， 如 提供 核心 服务 功能 的 资源 管理 子 系统 和 工作 台 。 作 为 
SAP WD4J 的 开发 工具 ，NWDS 正 是 在 这 些 标准 功能 之 上 扩展 了 许多 的 工具 和 服务 ， 并 且 相 
应 地 提供 不 同 的 视图 以 及 透视 图 给 不 同 开发 任务 的 开发 人 员 进 行 开 发 和 使 用 。 


对 于 SAP 在 NWDS 中 所 做 的 扩展 功能 ，SAP 既 努 力 保证 对 原 有 核心 功能 和 服务 优势 的 
利用 ， 同 时 也 尽 可 能 地 将 不 同 的 新 拓展 功能 使 用 同一 标准 的 操作 页 面 进行 集成 ， 减 少 了 开发 
人 员 学 习 和 培训 的 时 间 成 本 。 例 如 ,所 有 的 开发 组 件 (Development Component, DC) 项 目 
都 是 基于 元 数据 进行 创建 和 开发 的 ， 所 有 的 DTR (Design Time Repository) 相关 开发 动作 都 
拥有 同一 标准 的 操作 方式 和 显示 方式 。 男 外 ， 还 有 集成 在 NWDS 中 的 许多 向 导 功 能 或 Web 
Dynpro 开发 内 容 自 动 创建 功能 ， 也 都 是 经 过 SAP 的 标准 化 和 优化 后 的 结 

通过 这 一 系列 的 努力 ， 最 终 完成 了 SAP NetWeaver 开发 者 工作 室 这 个 WD4J 开发 平台 


一 一 一 个 基于 开源 的 Eclipse 软件 ， 同 时 具有 稳定 、 全 面 集成 等 特性 的 开发 架构 的 集成 开发 
环境 。 


1.2.2 功能 一 体 化 


NWDS 除了 拥有 平台 和 架构 的 优势 之 外 ， 还 适用 于 大 型 SAP NetWeaver 项 目 和 团队 协作 
开发 ， 并 在 Java 开放 式 平台 的 基础 上 (J2SE、J2EE、XML、Web 服务 等 ) 支持 SAP 相关 技 
Ñ (Web Dynpro, Java 字典 等 ) 以 及 SAP NetWeaver 开发 架构 。 

1. 与 SAP 开发 架构 集成 

NWDS 除了 提供 丰富 的 工具 集 以 支持 与 SAP 不 同类 型 项 目 相 关 的 Java 开发 以 外 ， 还 与 
强大 的 SAP NetWeaver 开发 架构 (NetWeaver Development Infrastructure, NWDI) 进行 了 深度 
集成 ， 使 其 成 为 了 一 个 能 够 覆盖 整个 WD4J 项 目 开发 周期 的 复杂 高 效 的 开发 场景 ( 见 图 1-3 ) 。 
这 一 功能 的 优势 在 需要 大 规模 开发 团队 同步 进行 开发 工作 时 尤为 明显 。 
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Basic properties of the selected element 


nh 


1-3 NWDS 中 开发 基础 架构 透视 图 


大 规模 的 开发 团队 需要 将 整体 开发 内 容 划 分 成 不 同 的 开发 模块 ， 并 分 配 至 不 同 的 开发 小 
组 ， 然 而 不 同 小 组 间 的 开发 也 有 可 能 有 代码 重合 的 部 分 ， 这 就 需要 NWDS 可 以 满足 统一 的 
开发 环境 、 代 码 同 步 以 及 版 本 管理 功能 。 

当然 ， 作 为 以 Eclipse 为 核心 的 开发 工具 ，NWDS 也 同样 对 本 地 的 开发 过 程 提 供 强 大 的 
支持 和 帮助 。 对 于 本 地 的 开发 过 程 ， 并 不 需要 应 用 Java 开发 架构 (Java Development Infra- 
structure, JDI), ， 但 通过 NWDS 的 工具 版 本 以 及 资源 库 的 统一 ， 不 同 的 本 地 开发 人 员 同 样 可 
以 在 各 自 的 个 人 计算 机 上 拥有 统一 的 开发 环境 。 在 开发 完成 后 ， 也 可 再 次 地 与 SAP HER 
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构 资 源 库 进 行 同 步 ， 使 不 同 开 发 方式 的 需求 都 能 被 满足 。 

以 下 是 在 实际 SAP 项 目 中 的 一 个 模拟 开发 过 程 : 

1) 当 一 名 开发 人 员 在 NWDS 中 打开 一 个 项 目 时 ， 首 先 需 要 保证 本 地 的 项 目 相 关 组 件 、 
类 库 以 及 Java 源 文件 可 用 ， 这 会 在 打开 NWDS 的 过 程 中 自动 进行 检查 。 

2) 开发 人 员 可 以 进行 必要 的 修改 ， 并 完成 本 地 的 一 个 新 的 编译 版 本 ， 也 可 以 通过 连接 
测试 服务 器 对 本 地 的 应 用 程序 进行 发 布 和 测试 ,测试 的 前 提 是 在 NWDS 的 选项 中 正确 配置 
J2EE 服务 器 的 相关 内 容 。 

3) 当 完 成 本 地 的 单元 测试 以 后 ， 只 要 确认 可 以 检 入 到 DTR 资源 库 中 ,就 可 以 通过 
NWDS 中 的 SAP 开发 架构 将 代码 同步 至 代码 资源 库 。 

4) 成 功 上 传代 码 后 ， 开 发 人 员 也 可 以 通过 NWDS 将 对 应 的 修改 进行 激活 ， 相 应 地 ， 开 
发 对 象 也 会 从 “未 激活 ”状态 变 为 “激活 ”状态 ， 这 个 过 程 需 要 服务 器 端 中 央 编 译 服务 的 
支持 。 然 而 与 传统 的 集中 编译 相 比 ， 节 省 了 需要 服务 器 集中 编译 的 处 理 时 间 ， 因 为 在 开发 人 
员 发 出 操作 请 求 的 同时 ， 可 以 实时 地 对 修改 过 的 开发 对 象 进 行 编译 和 激活 。 如 果 在 这 个 过 程 
中 发 后 错误 ， 开 发 人 员 从 NWDS 端 就 能 看 到 实时 的 错误 消息 ， 方 便 联 系 相 关 人 员 及 时 地 进 
行 故 障 排除 。 

5) 在 所 有 的 测试 以 及 激活 动作 成 功 完成 后 ， 修 改 的 相关 开发 对 象 就 可 以 被 释放 并 进行 
传输 了 。 同 样 地 ， 释 放 和 传输 也 都 可 以 通过 NWDS 端 在 相应 的 视图 中 操作 完成 ， 而 这 一 过 
程 也 同样 需要 服务 器 端 SAP 开发 架构 的 支持 。 

2. 与 服务 器 端 集成 

对 于 Eclipse 开发 工具 而 言 ， 更 多 地 用 于 本 地 Java 项 目 开发 ， 但 NWDS 则 不 然 ， 对 于 项 
目 中 拥有 较 大 权限 的 开发 人 员 来 说 ， 他 们 同样 也 可 以 通过 NWDS 对 SAP Java 应 用 服务 器 直 
接 进 行 服务 需 指 令 的 操作 和 执行 。 

在 执行 服务 器 指令 前 ， 首 先 需 要 进入 NWDS 的 “Management Console”， 选 择 添加 SAP 
服务 器 ， 并 在 弹出 的 对 话 框 中 输入 正确 的 服务 器 连接 信息 ， 如 图 1-4 所 示 注 意 ， 必 须 使 用 
操作 系统 管理 员 账 户 进行 连接 ， 同 时 ， 请 勿 泄露 管理 服务 器 管理 员 账 户 信 息 。 

在 连接 成 功 后 ， 就 能 在 对 应 视图 中 看 到 服务 器 的 运行 实例 、 运 行 状 态 以 及 硬件 使 用 情况 
等 信息 ， 如 图 1-5 所 示 。 
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图 1-4 输入 服务 器 连接 信息 对 话 框 图 1-5 管理 控制 台 视 图 


然而 在 这 个 视图 中 ， 不 仅仅 提供 给 开发 人 员 查看 服务 器 的 相关 信息 ， 使 用 相应 权限 的 账 
号 连接 后 还 可 以 通过 右 击 服务 需 实 例 弹 出 的 快捷 菜单 对 服务 需 进 行 启动 、 停 止 和 重启 等 操 
作 。 而 对 于 开发 人 员 来 说 ， 比 较 稼 用 的 是 切换 服务 器 实例 的 DEBUG 模式 ， 即 允许 本 地 应 用 
程序 在 服务 器 端的 断 点 调试 功能 。 

除了 对 服务 器 实例 的 操作 ， 还 可 以 通过 “Deploy View” 和 “Undeploy View” 使 用 手动 
方式 对 本 地 应 用 程序 包 (EAR 包 ) 进行 部 署 和 缉 载 等 操作 ， 而 在 相应 的 视图 中 也 可 以 实时 
地 查看 服务 器 端 应 用 的 运行 情况 是 否 正常 ， 使 核心 开发 人 员 只 需要 专注 于 NWDS 的 使 用 ， 
提升 了 整体 的 工作 效率 。 


1.2.3 用户 界面 和 工具 


NWDS 基本 的 界面 架构 与 Eclipse 类 似 ，SAP 也 是 在 尽 可 能 保持 界面 操作 与 Eclipse 一 
致 的 前 提 下 添加 一 些 与 NetWeaver 架构 相关 的 功能 和 服务 。 概 括 地 说 ， 用 户 界面 由 透视 
图 、 视 图 以 及 编辑 器 组 成 ， 每 一 个 组 件 都 是 通过 一 个 子 窗口 进行 展示 ， 而 当 多 个 视图 或 
编辑 絮 重 个 时 ,会 以 标签 页 的 形式 出 现在 一 个 窗口 中 ， 每 次 仅 有 一 个 视图 可 以 进行 访问 
和 操作 。 

透视 图 是 由 对 应 的 工具 栏 以 及 若干 视图 和 编辑 需 组 成 的 一 个 窗口 集合 ， 不 同 透视 图 的 默 
认 布 局 都 是 根据 该 透视 图 的 作用 和 开发 内 容 进 行 设计 的 。 当 然 ， 使 用 者 也 可 以 在 NWDS 的 
高 级 选项 中 对 不 同 透视 图 的 布局 和 显示 内 容 进 行 个 性 化 的 调整 。 当 需要 使 用 默认 的 透视 图 布 
局 显示 时 ， 也 可 通过 单 击 “Window” 一 “Reset Perspective” 命 令 ， 对 透视 图 布局 进行 重 置 。 
对 于 新 接触 NWDS 的 使 用 者 来 说 ， 透 视图 默认 包含 的 内 容 都 覆盖 了 对 应 开发 内 容 的 标准 功 
能 和 服务 ， 建 议 在 熟悉 相关 操作 后 再 尝试 着 进行 透视 图 的 个 性 化 设置 。 

编辑 带 是 在 编写 代码 时 打开 的 窗口 ， 通 过 编辑 带 开 发 人 员 才 可 以 对 开发 对 象 的 代码 进行 
修改 和 更 新 。 在 NWDS 中 ， 默 认 会 对 代码 的 编译 错误 进行 实时 地 提醒 ， 但 并 不 会 对 代码 进 
行 实时 地 保存 ， 需 要 通过 工具 栏 中 “保存 ”按钮 或 菜单 中 的 “保存 ”命令 对 修改 的 开发 对 
象 进行 及 时 保存 。 除 了 Eclipse 标准 支持 的 Java 代码 以 及 文本 编辑 之 外 ，NWDS 还 提供 了 一 
些 额 外 的 编辑 器 。 例 如 ，EJB 编辑 器 用 于 查看 和 修改 EJB 的 对 应 配置 ， 并 可 通过 按钮 直接 跳 
转 至 对 应 接口 或 Java 类 的 代码 ; Web Dynpro 视图 编辑 髓 提供 开发 人 员 以 图 形 化 的 方式 进行 
Web Dynpro 视图 的 设计 和 开发 。 

视图 则 是 用 于 查看 开发 对 象 相 关 的 各 种 信息 ， 最 常见 的 就 是 通过 一 个 树 状 结构 展示 
项 目 结构 以 及 项 目 包 含 的 开发 对 象 ， 或 者 显示 Web Dynpro 视图 中 元 素 的 结构 ， 或 者 显示 
开发 对 象 的 属性 、 编 译 错 误 消 息 以 及 运行 日 志 等 内 容 。 开 发 人 员 可 以 通过 单 击 “Window” 
一 “Show View” MS, 方便 地 在 当前 透视 图 中 添加 自己 想 要 查看 的 视图 。 在 大 部 分 的 透 
视图 中 ， 左 上 窗口 显示 项 目的 结构 及 包含 的 开发 对 象 ， 右 上 窗口 用 于 打开 开发 对 象 的 编 
辑 器 ， 左 下 窗口 显示 开发 对 象 的 结构 (如 Java 类 结构 或 Web Dynpro 视图 结构 ) ， 右 下 窗 
口 则 显示 属性 、 日 志 等 相关 信息 。 图 1-6 显示 的 是 Web Dynpro 的 透视 图 ， 默 认 共 有 4 个 
窗口 显示 在 主 界面 中 ， 每 个 窗口 中 又 分 别 三 加 了 若干 的 视图 在 其 中 。 

NWDS 中 提供 了 类 型 丰富 的 透视 图 ， 对 应 了 不 同 的 开发 需求 以 及 工具 集 的 使 用 ， 而 大 部 
分 的 透视 图 的 使 用 与 传统 的 Java 工程 开发 类 似 ， 所 以 在 这 里 只 重点 介绍 一 下 Web Dynpro 透 
视图 ,不 再 对 其 他 各 个 透视 图 一 一 介绍 ， 这 是 为 读者 开展 后 续 的 Web Dynpro 开发 工作 做 好 
铺垫 。 
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图 1-6 NWDS 中 的 Web Dynpro 透视 图 


1.2.4 Web Dynpro 透视 图 


Web Dynpro 技术 作为 基于 SAP Web AS 的 新 一 代 编 程 技术 ， 不 仅 提 供 必 要 的 运行 服务 以 
及 元 数据 模型 的 支持 ， 还 提供 了 一 系列 设计 开发 工具 集成 在 NWDS 里 的 Web Dynpro 透视 图 
中 ， 为 开发 人 员 整 个 项 目 周期 的 工作 提供 支持 和 保障 。 这 其 中 包括 了 以 下 内 容 : 

e 在 开发 环境 中 提供 丰富 的 功能 菜单 ， 如 创建 和 生成 项 目 组 件 、 导 入 和 应 用 模型 ， 或 发 

布 并 运行 测试 应 用 程序 等 功能 。 

e 大 部 分 的 Web Dynpro 开发 内 容 都 可 以 通过 向 导 的 形式 ， 如 不 同类 型 的 Web Dynpro 模型 

导入 ， 组 件 的 创建 以 及 对 应 视图 和 窗口 的 生成 ， 通 过 应 用 模板 方式 创建 视图 元 素 等 。 

o 对 于 应 用 程序 界面 的 开发 使 用 图 形 化 编辑 辑 ， 一 方面 支持 视图 元 素 的 图 形 化 支持 ， 另 

一 方面 只 是 元 素 对 应 逻辑 事件 的 自动 生成 ， 尽 可 能 地 将 开发 人 员 的 代码 编写 工作 最 
小 化 。 

图 1-6 是 Web Dynpro 透视 图 的 实际 截图 ， 除 了 截图 中 看 到 的 视图 以 外 ， 还 包含 了 Web 
Dynpro 浏览 器 视图 、 导 航 器 视图 、 视 图 设计 器 、 模 型 类 设计 器 以 及 控制 器 设计 央 等 功能 。 

Web Dynpro 浏览 吉 (Web Dynpro Explorer) 是 Web Dynpro 透视 图 的 核心 部 分 ， 它 为 本 
地 或 是 基于 开发 组 件 的 Web Dynpro 项 目 提供 了 一 个 逻辑 结构 视图 ， 可 以 通过 浏览 器 了 解 
Web Dynpro 项 目的 具体 结构 ， 也 可 以 查看 组 件 和 窗口 的 关系 、 模 型 的 引用 以 及 组 件 接口 的 
使 用 等 内 容 。 而 在 同一 窗口 中 ， 透 视图 也 提供 了 一 个 导航 器 (Navigator) ， 用 于 查看 项 目 在 
实际 本 地 计算 机 中 的 目录 结构 以 及 开发 对 象 所 对 应 的 实际 文件 清单 。 

与 Web Dynpro 开发 相关 的 视图 设计 器 、 控 制 器 设计 器 等 视图 ， 都 可 以 通过 双击 Web 
Dynpro 中 对 应 的 组 件 自 动 打开 相应 的 编辑 器 并 进行 图 形 化 的 操作 (如 引用 关系 、 视 图 舰 套 
等 ) ; 对 于 图 形 化 操作 比较 陌生 的 开发 人 员 ， 可 以 在 属性 视图 中 进行 手动 配置 ， 两 者 都 能 达 
到 相同 的 效果 。 

旧版 本 中 的 上 下 文 编辑 器 、 方 法 定义 、 动 作 定义 等 都 已 集成 到 了 属性 视图 中 ， 以 方便 开 
发 人 员 进 行 查找 和 定位 。 


第 2 7% Hello World 应 用 


在 了 解 了 Web Dynpro 技术 的 平台 支持 以 及 工具 支持 之 后 ， 下 面 介 绍 “Hello Word 应 
用 ”， 并 带领 大 家 进入 Web Dynpro for Java 的 新 世界 。 


2.1 创建 项 目 


1) 首先 运行 开发 工具 SAP NetWeaver 开发 者 工作 室 (NWDS) 的 应 用 程序 “Sap- 
NetweaverDeveloperStudio. exe”， 在 启动 过 程 中 NWDS 会 自动 加 载 必 要 组 件 并 进行 开发 环境 的 
检查 ， 如 图 2-1 所 示 。 由 于 实例 中 使 用 的 测试 服务 器 是 NetWeavero 7.4 版 本 ， 因 此 开发 工具 
需要 使 用 对 应 的 “EHP1 for NWDS 7. 3” 版 本 。 


DEVELOPER STUDIO 


Release Version = EHP1 for SAP NetWeaver Developer Studio 7.3 


Copyright © SAP AG, 2005-2011. All Rights Reserved 


器 


2-1 开发 者 工作 室 的 启动 界面 


2) 默认 进入 欢迎 界面 ， 如 果 是 首次 运行 ， 会 弹出 一 个 JVM 的 报错 消息 ( 见 图 2-2)， 
这 是 由 于 NWDS 的 运行 环境 必须 先 指定 对 应 的 IDK 路 径 。 单 击 “OK” 按钮 。 


ins SAP HetWeaver Heveloper Studio Startup Configuration - {oj xj 


By, You ere running Developer Studio with an unsupported JVM. Click Details for 
[x] more information, Press OK to locate a supported JVM, 
Reason: 
You have to use a JDK as a JVM instead of a JRE 


man» | 


Al 2-2 首次 启动 时 报错 消息 框 


3) 在 弹出 的 对 话 框 中 对 应 本 地 计算 机 中 已 安装 的 jdk 路 径 ， 找 到 “javaw. exe” 文 件 并 
单 击 “ 打 开 ” 按 钮 ， 如 图 2-3 所 示 。 其 中 jdk 参考 路 径 为 …/Java/jdk1. 6. 0_30/bin, 
10 


HI 


2015/12/23 14:17 


= 

T 最 近 访 问 的 位 置 
wk 

视频 

ee! 

2 音乐 
到 计算 机 


& Ais C) 
c SAM OD 


SEIN): [jovaw.exe | [javaw.exe >| 
= 


2-3 选择 正确 的 jdk 路 径 


4) 指定 对 应 的 JDK 后 ,会 弹出 另 一 个 消息 提醒 ( 见 图 2-4)， 需要 重启 NWDS 程序 才 
能 使 配置 生效 ， 单 击 “Exit” 按 钮 并 重新 运行 NWDS， 以 完成 NWDS 初始 化 配置 。 


VA 


@ Developer Studio successfully configured to run with the Located TAL Tou 


[全 SAF WetWeaver Deweloper Studio Startup Conk pur ation 


have to restart. Developer Studio for the changes to teke effect. To restart 
Developer Studio, close it and run SapNetweaverDeveloperStudio, axa, 


If you used a shortcut to start Developer Studio, you have to correct the 
shortcut manually. 


Click Exit to close Developer Studio, 


Al 2-4 ”配置 完成 后 提醒 消息 框 


5) 再 次 运行 开发 者 工作 室 程 序 后 ， 首 先 看 到 的 是 一 个 欢迎 界面 ， 提 供 了 一 些 简 单 的 向 
导 以 及 相关 描述 信息 ( 见 图 2-5)， 单 击 “Workbench” 按 钮 返回 到 工作 台 主 界面 。 
6) 单 击 “File” 一 “New” 一 “Project” 命 令 ， 创 建 一 个 新 的 项 目 ， 如 图 2-6 所 示 。 


SAP NetWeaver Developer Studio 


© fF EE E 


Overview Tutorials Samples What Next? Workbench 


图 2-5 进入 NWDS 后 的 默认 按钮 
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th Save fll 


Grrl 


Glose 4l| Gor Shifty Ey Untitled Text File 
Save Grits 

H: E Example... 

| Save As,,, 


Gtrl+-shift+-S 


Cj Other... 


图 2-6 创建 一 个 新 项 目 


7) 在 弹出 的 对 话 框 中 选择 “Web Dynpro Development Component” 类 型 ( 见 图 2-7) ， 
单 击 “Next” 按 钮 。 
8) 选择 在 本 地 开发 并 在 “MyComponents” 中 进行 创建 ( 见 图 2-8)， 单 击 “Next” 


按钮 。 


Select a wizard 


Create a new Web Dynpro development component 


Wizards: 


‘web 


4 @ Web 


G Dynamic Web Project 
ĝi Static Web Project 
4 @ Web Dynpro 


| 3 Web Dynpro Development Component) 


BS 


2-7 


选择 创建 项 目 类 型 


New Development Component (Project) 


Select Software Component 


Select the software component where you want to create 
the DC(s). The settings for the selected component will be 


4 LocalDevelopment 
| 84 MyComponents [demo.sap.com] | 


Al 2-8 选择 开发 组 件 


9) 在 弹出 的 对 话 框 中 输入 项 目的 名 称 和 标题 ( 见 图 2-9) ， 单 击 “Finish” 按 钮 。 
10) 至 此 成 功 创建 了 一 个 新 的 Web Dynpro 项 目 ， 如 图 2-10 所 示 。 


New Development Component (Project) 


New Development Component 


Create New Development Component (Project) 


(1S ls) 


Vendor: 
Name: 
Caption: 
Language: 


Domain: 


Support Component: i 


demo.sap.com 


X | mydynp01 


mydynp01| 


4 [3 [LocalDevelopment] mydynp01 


American English 


a yi Web Dynpro 


Ra Applications 


Basis 


a Models 


af) Component Interfaces 


(For Example BC-DWB-FOO) 


[¥] Keep DC Local for Now (Use 'Add to Source Control’ Later) 


图 2-9 输入 项 目的 基本 信息 


72 


(网 Components | 
> @ Dictionaries 


> @ Resources 


图 2-10 创建 完成 后 的 Web Dynpro 项 目 


2.2 创建 组 件 


1) 如 同 Java 工程 由 包 和 类 组 成 ，Web Dynpro 工程 则 是 由 组 件 组 成 的 。 展 开 项 目的 清 
单 ， 右 击 “ Components”， 在 弹出 的 快捷 菜单 中 选择 “Create Component” 创 建 一 个 组 件 ， 
如 图 2-11 所 示 。 

2) 输入 组 件 的 名 称 “Dynp01Comp”， 选 中 创建 默认 的 窗口 和 视图 ( 见 图 2-12) ， 单 击 
“Next” 按 钮 。 注 : 在 Web Dynpro 中 的 很 多 开发 可 以 通过 标准 的 向 导 功 能 完成 ， 在 一 定 程度 
上 减少 了 手动 配置 的 工作 量 。 


New Compone: 


4 © [LocalDevelopment] mydynp01 — 
4 $ Web Dynpro || Specify Component Properties 
Œ Applications Enter name and package for the new Web Dynpro Component 
$È Models 


Component Interfaces 


Component Name Dynp01Comp 


Create Component Component Package com.sap.demo.mydynp01.wd.comp.dynp01con 
Paste 


Apply Template 


Choose additional capabilities for the new component 


加 Default Window and Views 
Development Component [F] Used Models 


Compare Metadata 


Remove from Context [E] Implemented Interfaces 


图 2-11 创建 一 个 组 件 图 2-12 输入 组 件 的 基本 信息 
3) 输入 窗口 的 名 称 “Dynp01CompWindow” 以 及 接口 视图 的 名 称 “Dynp01 CompInter- 
face View”( 见 图 2-13) ， 单 击 “Finish” 按钮 。 
4) 在 完成 组 件 、 窗 口 和 视图 的 创建 后 ， 在 Web Dynpro 浏览 器 中 可 以 看 到 一 个 典型 的 
Web Dynpro 项 目 结构 ， 如 图 2-14 所 示 。 


[fe New Compor 


|| Specify Window Properties 
Enter the name for the default Window and Interface View. Specify new 


View(s) to embed into the Window. 


Window Name Dynp01CompWindow 


Interface View 


Interface View Dynp01CompinterfaceView 


re 
= J fr 
BS! Sl t 


4 区 [LocalDevelopment] mydynp01 
a yi Web Dynpro 
a Applications 


V] Create Start-Up Plug (for Application Reference) 


Embed Views @ Models 
ff] Component Interfaces 
Name Embed Default 4 «i Components 
Dynp01CompView 加 四 


4 (di Dynp01Comp| 


ee Component Controller 
Remove 站 P 


> 图 Local Component Interface 


$ Custom Controllers 

@® Implemented Interfaces 
E] Message Pool 

@y Used Models 

«i Used Components 


四 <Back | Next> | [Finish aol > T Views 
| 一 Db Windows 
图 2-13 输入 窗口 和 视图 的 名 称 图 2-14 默认 组 件 的 目录 结构 
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5) 在 右 侧 的 模型 编辑 器 中 可 以 看 到 各 个 对 象 之 间 的 关系 ， 如 图 2-15 所 示 。 


4 


[LocalDevelopment] mydynp01 Jay Dynp01Comp | 


图 2-15 PEM SFE ae PAIT 
6) 展开 “Views” 视 图 ,并 双击 通过 向 导 创 建 的 视 


图 。 在 左下 角 的 “Outline” 中 右 击 “RootElement”， 
出 的 快捷 菜单 中 选择 “Insert Child” , 
如 图 2-16 所 示 。 

注 : ÆA Web Dynpro 的 视图 中 都 会 固定 有 一 个 根 元 
素 ， 且 无 法 被 删除 。 

7) 在 弹出 的 对 话 框 中 选择 插入 元 素 的 类 型 ， 前 两 个 
选项 区 用 于 显示 不 同 元 素 类 型 的 日 录 分 类 ， 第 三 个 选项 
区 是 具体 的 元 素 对 象 。 在 “UI Element” 选 项 区 中 选中 
“TextView”， 单 击 “OK” 按 钮 ， 如 图 2-17 所 示 。 

8) 在 右 下 方 的 属性 选项 卡 中 ,将 “TextView” 的 
文本 内 容 修 改 为 “This is Hello World Applica- 
如 图 2-18 所 示 。 


在 弹 
插入 一 个 子 元 素 ， 


“ text” 


tion” , 


Insert Child... 


Cut 


Copy 
Paste 


Replace With 
X Delete 


Move Up 


Move Down 


Parameter Mapping 
Translatable Texts 


Apply Template 
d Binding Chain 


Expand All 
Show Help 


Properties 


上 Context Menus 


New UI Element 0 > 一 一 -一 — = = 


Create a new UI element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library 


UI Element 


[AI [Al] 
Action Active Components 
Adobe 


Analytics 


Complex 
Graphic 
Integration Business Graphics 
Layout Business Intelligence 
Menu Calendar 

Selection Mobile Add-Ons 
Text Office Integration 
Toolbar Pattern Development 
Realtime Messaging 


Standard 


Table 

TabStrip 

区 | TextEdit 

[E] TextView 

@ TimedTrigger 
ToggleButton 

+a ToggleLink 
==ToolBar 

=P ToolBarButton 

E ToolBarButtonChoice 


‘SF ToolBarDropDownByindex 
ig ToolBarDropDownByKey 
= ToolBarinputField 


ZA ToolBarLinkChoice 


ID TextView 


Documentation 


The TextView is used to display a multiline (plain) text in a number of designs. 


design andthe semanticColor properties. 


If vant want tn nlara unnur own markun incida the tavt nca 2 FarmatradTavVi ow 


Line breaks may forced be inserting the character '\n' inside the text. The appearance of the text may be controlled using the 


© 


BS 


2-17 选择 元 素 类 型 
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Ctrl+X 
Ctrl+C 
Ctrl+V 


> 


Delete 


Alt+Enter 


图 2-16 插入 子 元 素 的 菜单 选择 


9) 依次 将 “design” 属 性 修改 为 “headerl”、 将 “semanticColor” 属 性 修改 为 
“marked2”、 将 “width” 属性 修改 为 “500px”， 如 图 2-19 所 示 。 完 成 所 有 修改 后 ， 单 击 开 
发 工具 左上 方 的 “保存 ”按钮 ， 或 按 〈Ctrl +S) 组 合 键 进 行 保存 。 


区 Problems | j x [E Snippets | [E] Infrastructure Console | 9) Error Log | 4] Tasks | 
TextView 
General id TextView 

全 ”| layout native* 

ube. contextMenuBehaviour inherit* 
contextMenuld 
design standard* 
enabled true 
hAlign auto* 
semanticColor standard* 
ext This is Hello World Application 
textDirection inherit* 
tooltip a 
visible visible* 


图 2-18 修改 元 文本 属性 


局 Problems | =) Properties £3 » ES Snippets Infrastructure Console | @) Error Log| ¥ Tasks 
TextView 
General contextMenuld 
esate | design headerl 
enabled true 
hAlign auto* 
text This is Hello World Application 
textDirection inherit* 
tooltip & 
visible visible* 
wrapping false 
图 2-19 ”修改 元 素 属性 


2.3 配置 服务 器 


1) 在 部 署 Web Dynpro 程序 之 前 ， 还 需要 配置 部 署 服 务 器 的 地 址 ， 如 同 在 运行 HTML 页 
面 之 前 必须 指定 tomcat 地 址 一 样 。 单 击 “Window” 一 “Preferences” 命 令 ， 进 行 配 置 管理 ， 
如 图 2-20 所 示 。 

2) 在 弹出 的 对 话 框 中 左上 方 的 文本 框 中 输入 “sap” 进 行 模糊 搜索 ( 见 图 2-21) ， 
在 左 侧 的 列表 中 选择 “SAP AS java”， 默 认 右 侧 列 表 内 容 是 空 的 ， 单 击 右 侧 的 “Add” 
按钮 。 

3) 输入 需要 部 署 程序 的 服务 器 进行 连接 ， 如 图 2-22 所 示 。 

注 : 图 2-22 中 的 IP 仅 作为 参考 ， 请 根据 实际 服务 器 地 址 进行 相关 配置 。 

4) 完成 添加 后 ， 就 会 出 现 对 应 服务 器 的 主机 名 ， 这 样 就 可 指定 服务 器 并 部 署 Web Dyn- 
pro 程序 了 ， 如 图 2-23 所 示 。 
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New Window 

New Editor 

Open Perspective » 
Show View » 


Customize Perspective... 
Save Perspective As... 
Reset Perspective... 
Close Perspective 
Close All Perspectives 


SAP AS Java 
SAP Management Cons 
SAP NetWeaver Gatew: 


Navigation » SAP NetWeaver Portal 
Preferences 4 XML 


Al 2-20 修改 配置 菜单 图 2-21 配置 中 的 模糊 查询 


Specify a host name and an instance number of an instance that belongs to the system to add 


Instance Host Nam 127.0.0.1 
Instance Number: 01 


Add to Domain 


Use HTTPS: 回 


图 2-22 输入 服务 器 连接 信息 


SAP AS Java 


SAP AS Java 
SAP Management Cons 
SAP NetWeaver Gatew: 
SAP NetWeaver Portal System Instance/Number Default System 
4 XML EPE © 
4 XML Files QAS © 
4 Editor 


Syntax Coloril 


Add or remove SAP Systems to be used for monitoring, 
Select a default system for deployment. 


2-23 ”服务 器 信息 配置 后 示例 


2.4 部 署 应 用 程序 


1) 回 到 项 目 目 录 中 ， 右 击 “Applications”， 在 弹出 的 
快捷 菜单 中 选择 “Create Application”， 创 建 一 个 应 用 程 
序 ， 如 图 2-24 所 示 。 

2) 输入 应 用 程序 的 名 称 “Dynp01App” ( 见 图 2-25)， 
单 击 “Next” 按 钮 。 

3) 选中 “Use Existing Component” 单 选 按钮 (JL 


Create Application 


Paste 


Compare Metadata 


Development Component 


器 


2-24 创建 一 个 应 用 程序 
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图 2-26) ， 单 击 “Next” 按 钮 ， 确 认 信息 后 ， 单 击 “Finish” 按 钮 。 


一 - ns New Application 
fe New Application — 


Choose Referenced Web Dynpro Component 


Application Properties i uy 
j 二 You can either reference an existing Web Dynpro comp 
Enter the properties for the new application 


Name Dyn01A\pp 

i Referenced Web Dynpro Component 
Package com.sap.demo.mydynp01.wd.app.dyn0lapp © Use Existing Component 
© Create a New Component 


F] Authentication 


图 2-25 输入 应 用 程序 名 称 图 2-26 选择 引用 组 件 类 型 


4) 完成 应 用 程序 的 创建 后 ， 就 可 以 看 到 在 模型 编辑 器 中 应 用 程序 其 实 是 引用 的 组 件 中 
的 窗口 的 接口 视图 ， 如 图 2-27 所 示 。 

5) 右 击 新 建 的 “ Dynp01 App” 应 用 程序 ， 在 弹出 的 快捷 菜单 中 选择 “ Deploy New Ar- 
chive and Run”， 部 署 新 版 本 并 运行 ， 如 图 2-28 所 示 。 


(m [LocalDevelopment] mydynp01 > È DynpolComp |B Dynp01CompView | | 


x [LocalDevelopment] mydynp01 


4  [LocalDevelopment] mydynp01 
4 yA Web Dynpro 


A | Dynp01Comp ea 
la 4% Applications 

Dyn App = a 
| 国 pyrpoicompwndon j 4 Model ps 
| 万 Comp Open Data Modeler 
| 4 Comp Record 
| 4 of Dy X Delete 
| @ Copy 
| > Deploy New Archive and Run 


图 2-27 模型 编辑 器 中 的 效果 图 2-28 运行 应 用 程序 


6) 部 署 完毕 ， 弹 出 确认 对 话 框 ， 单 击 “OK” 按钮 (建议 选中 “Donot show this dialog 
again” 复 选 框 )， 如 图 2-29 所 示 。 

7) 自动 打开 默认 浏览 器 ， 并 在 指定 的 服务 器 端 运行 刚才 实例 中 创建 的 “Hello World ” 
应 用 ， 运行 效果 如 图 2-30 所 示 。 


Deploy 


Deploy finished successfully. 


E] Do not show this dialog again 文件 (Fi) SHE) BBM mA IAT WH) 


网 2-29 部署 完 毕 的 确认 对 话 框 图 2-30 Wl 


SF 
= 
iN 
my 
Sk 
No 
7 也 
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37% WD4J 工程 详解 


本 章 将 详细 地 对 Web Dynpro for Java 工程 各 个 部 分 进行 介绍 ， 包 括 Web Dynpro 的 视图 、 
窗口 、 控 制 旨 等 内 容 ， 同 时 每 一 节 的 内 容 都 会 补充 相关 的 开发 实例 ， 帮 助 读者 更 好 地 将 理论 
与 开发 实践 相 结 合 。 


3.1 WD4J 工程 简介 


SAP 对 于 标准 的 MVC 设计 模式 做 了 一 些 重 要 的 改变 : 

© 标准 的 MVC 允许 模型 发 生变 化 时 直接 通知 对 应 视图 ， 这 并 未 在 Web Dynpro 中 
应 用 。 

o 标准 的 MVC 允许 府 套 型 视图 控制 器 ， 这 在 Web Dynpro 中 是 不 允许 的 。 

© SAP 对 设计 模式 进行 了 扩展 ， 添 加 了 一 个 集合 体 ， 也 就 是 Web Dynpro 工程 中 的 组 件 
(Component) 。 图 3-1 所 示 是 一 个 典型 的 Web Dynpro 组 件 。 


对 外 可 见 


F r 
i 
& 
a 
Š 
S 
oo 
v 
8 4 
o 
on 
s 
N 


图 3-1 Web Dynpro 组 件 架 构图 


Web Dynpro 组 件 的 说 明 如 下 : 

从 整个 架构 来 看 ， 一 个 Web Dynpro 组 件 可 以 分 为 以 下 几 个 部 分 : 

D 水平 虚线 将 整个 组 件 的 实体 分 割 为 两 块 : 对 组 件 外 部 可 见 部 分 (包括 接口 视图 、 接 
口 控制 器 ) 和 仪 对 组 件 内 部 可 见 部 分 (包括 视图 、 窗 口 、 控 制 絮 等 )。 

D 垂直 虚线 也 将 整个 组 件 的 实体 分 割 为 两 块 : 可 视 化 实体 和 不 可 视 实体 (或 代码 
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实体 ) 。 
一 个 Web Dynpro 组 件 仅 有 接口 视图 和 接口 控制 器 对 外 可 见 、 
1) 所 有 的 Web Dynpro 组 件 都 有 一 个 接口 控制 器 。 
2) 一 个 窗口 与 一 个 接口 视图 始终 是 一 对 一 的 关系 (注意 ， 是 窗口 而 不 是 视图 )。 
3) 组 件 里 不 存在 窗口 是 “匿名 ”的 。 
© 虽然 在 一 个 Web Dynpro 组 件 中 所 有 的 控制 器 都 是 独立 编写 代码 ， 但 它们 都 共同 扮演 
着 MVC 中 “C” 的 角色 ， 并 且 没 有 控制 器 是 脱离 组 件 而 存在 的 。 
© Web Dynpro 模型 ， 也 就 是 MVC 中 的 “M” 是 在 组 件 之 外 的 ， 因 为 在 Web Dynpro 中 模 
型 可 以 被 多 个 组 件 交 叉 使 用 。 
e 一 个 Web Dynpro 组 件 可 以 声明 引用 其 他 Web Dynpro 组 件 。 在 声明 之 后 ， 一 个 组 件 引 
用 会 在 父 组 件 中 创建 ， 而 子 组 件 中 功能 和 方法 的 调用 则 是 通过 子 组 件 的 接口 控制 器 进 
行 的 。 
Web Dynpro 工程 实例 : 
回 到 在 上 一 章 中 创建 的 Web Dynpro 工程 ， 再 次 看 一 下 在 实际 开发 工具 中 的 目录 结构 
( 见 图 3-2): 


最 顶层 是 整个 Web Dynpro 工程 的 根 目录 结 点 Lo- F ad Serena mydynpol 
calDevelopment] mydynp01 ， 这 也 是 一 个 可 发 布 的 单元 。 Ha Applications 
下 一 层 包 含 Web Dynpro, Dictionaries 和 Resources ris ores 
( 在 旧版 本 中 是 src). 4 $Â Components 
© Web Dynpro: 包含 所 有 的 Web Dynpro 程序 、 模 型 和 r roe 
组 件 。 Local Component Interfac 
© Dictionaries, 对 应 于 具体 的 数据 层 ， 建 立 与 后 台 表 eran 
结构 相映 射 的 结构 以 及 固定 数据 的 选择 范围。 Sa 
© Resources; 包括 Web Dynpro 所 有 定制 开发 组 件 的 描 «å Used Components 
述 文件 、 资 源 文件 (本 地 的 图 片 、HTML 静态 页 而 Eee 


等 ) 以 及 Java 代码 源 文件 。 
在 Web Dynpro 中 包含 了 应 用 程序 (Applications) 、 模 图 3-2 Web Dynpro 项 目 
型 (Models)、 组 件 (Components) 等 部 分 。 目录 结构 个 例 
e 应 用 : 从 开发 人 员 的 角度 来 看 ， 应 用 是 将 组 件 封装 打包 后 的 可 运行 对 象 ， 是 整个 工程 
的 “成 品 ”， 从 最 终 用 户 的 角度 来 看 ， 程 序 同 时 创建 了 一 个 指向 具体 应 用 场景 的 用 户 
入 口 ， 每 个 程序 对 应 单独 一 个 URL 访问 链接 。 
© 模型 : 用 于 封装 外 部 业务 数据 模型 ， 并 创建 唯一 的 接口 作为 远程 服务 调用 ， 如 REC, 
WebService 等 外 部 系统 接口 调用 。 模 型 为 组 件 提供 了 丰富 的 原始 数据 ， 即 来 自 于 不 同 
系统 或 外 部 接口 的 “原料 ”。 
o 组 件 : 组 件 是 整个 Web Dynpro 工程 的 核心 ， 是 工程 的 业务 逻辑 处 理 单元 ， 包 含 了 所 
有 的 可 定制 开发 的 应 用 场景 ， 包 括 视 图 、 窗 口 、 组 件 控制 器 等 对 象 。 组 件 无 法 通过 
URL 直接 访问 ， 但 它 的 接口 视图 和 接口 控制 器 可 以 被 其 他 组 件 所 访问 。 
从 导 辑 角度 来 说 ， 组 件 中 的 视图 定义 了 用 户 的 操作 界面 ， 窗 口 是 视图 的 载体 ， 同 时 一 一 
对 应 地 实现 了 一 个 接口 视图 。 接 口 视图 作为 组 件 的 出 口 ， 在 创建 应 用 时 被 引用 。 最 终 整 个 
Web Dynpro 工程 建立 了 这 样 一 个 关联 : View - Window - InterfaceView - Component — Applica- 
79 


tion, 


这 也 是 第 2 章 中 Hello World 工程 的 骨架 。 


3.2 视图 


分 


Web Dynpro 的 视图 (View) 是 唯一 的 Web Dynpro 组 件 中 与 最 终 用 户 面对面 交流 的 部 


， 用 户 的 操作 通过 视图 中 的 UI 元 素 完成 ， 而 程序 的 逻辑 处 理 则 是 通过 视图 的 控制 器 来 完 


成 的 。 
3.2.1 视图 的 生命 周期 


当 一 个 Web Dynpro 组 件 实例 创建 时 ， 默 认 视 图 也 会 创建 相应 的 实例 对 象 。 如 果 不 是 组 


件 的 默认 视图 ， 则 它 会 在 指向 它 的 导航 请 求 触发 时 创建 实例 对 象 ， 直 到 窗口 关闭 或 者 有 其 他 
的 页 面 切换 请 求 被 触发 。 


装 。 


从 J2EE 的 角度 考虑 ，Web Dynpro 的 视图 组 件 开 发 可 以 看 成 是 对 JSP BK Servlet 的 封 
该 组 件 在 服务 端 执 行 并 生成 可 以 在 客户 端 浏 览 执行 的 HTML 源 文件 ， 人 们 对 视图 的 


开发 就 演变 成 对 JSP 的 高 级 开发 ， 更 多 的 图 形 界面 元 素 是 基于 可 定制 与 模板 化 ， 并 伴随 着 
代码 的 自 定义 生成 。 视 图 有 其 生命 周期 视图 中 有 一 些 方法 在 其 生命 周期 的 不 同 阶段 点 
会 执行 。 
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整个 视图 生命 周期 中 可 能 会 执行 到 的 标准 方法 如 下 。 

e wdDolInit( ) : 这 是 所 有 控制 器 〈 包 括 组 件 控 制 器 和 视图 控制 锅 ) 的 默认 初始 化 方法 ， 

且 在 实例 初始 化 时 仅 执行 一 次 ， 因 此 对 于 视图 中 屏幕 元 素 的 初始 化 或 者 变量 的 默认 值 

设 定 都 在 这 个 方法 中 完成 。 

wdDoExit( ) : 与 wdDolnit( ) 相对 ， 该 方法 在 每 个 控制 器 结束 时 执行 。 视 图 的 退出 场景 

有 很 多 ,包括 视图 失效 、 窗 口 关 闭 、 视 图 切换 等 。 该 方法 也 是 每 个 控制 器 实例 的 

出 口 。 

wdDoModifyView( ) : 该 方法 在 视图 实例 初始 化 以 及 运行 中 视图 的 页 面 UI 元 素 产 生 事 

件 触 发 时 执行 。 由 于 这 个 方法 与 视图 页 面 UI 元 素 直 接 相关 ， 因 此 仅 在 视图 控制 器 

(View 的 Java 代码 ) 中 存在 ,组 件 控制 器 中 没有 这 个 方法 。 该 方法 的 默认 参数 为 

firstTime， 布 尔 型 ， 用 于 标记 屏幕 是 第 一 次 创建 还 是 属于 重 绘 ;如 需求 有 动态 绘制 UI 

元 素 等 内 容 ， 创 建 动态 元 素 的 代码 就 在 wdDoModifyView 方法 中 编写 ， 也 可 根据 情况 

编写 部 分 初始 化 代码 。 需 要 注意 的 是 ， 由 于 每 次 UI 控件 事件 的 触发 都 会 执行 该 方法 ， 

该 方法 在 视图 的 整个 生命 周期 中 执行 频率 最 高 ， 因 此 除了 表格 的 过 滤 与 排序 等 必要 的 

需求 场景 外 ， 并 不 建议 在 wdDoModifyView( ) 中 编写 过 多 代码 。 为 了 避免 破坏 MVC 的 

设计 理念 ，SAP 也 将 这 个 方法 限制 为 静态 类 型 。 

© wdDoBeforeAction(): 该 方法 在 界面 控件 的 Action 事件 触发 前 执行 。 一 般 情况 下 ， 数 
据 有 效 性 校 验 会 在 wdDoBeforeAction 中 编写 ， 校 验 会 直接 指向 页 面 元 素 指 针 ， 若 校 验 

通过 Action ， 则 继续 执行 ; 若 校 验 失 败 ， 则 抛 出 异常 并 且 页 面 元 素 显 示 红 色 ， 程 序 
BT 

项 目 开 发 人 员 需 要 特别 注意 方法 执行 顺序 : 

在 视图 初始 化 时 ， 先 执行 wdDolInit( ) 方 法 ， 后 执行 wdDoModifyView( ) 方 法 。 

在 触发 视图 的 界面 UI 控件 的 事件 后 ， 先 执行 wdDoBeforeAction( ) ， 然 后 执行 控件 事件 ， 


最 后 执行 wdDoModifyView( ) 方 法 。 


开发 实例 : 


1) 从 刚刚 新 建 的 视图 切换 到 Java 编辑 器 视图 中 ， 选 择 “ Outline” 


Domit( ) ”初始 化 方法 ， 如 图 3-3 所 示 。 


gom/sap/demo/mydynp01/wd/comp/dynpOlcomp 


选项 卡 中 的 “wd- 


Fle Edit Some merem 一 一 Search Project Editor —— Run Window Help 


t+ G2 PE Mis Di hs Bi*-O-Q~- i @Ov- i P 4H TM Br Hr wero 
Pl Web Dynpro 23 N IP Search Con | #5: Navigator] = O |[£) Dynp02CompViewjava £2 \_ mi 
BS| Sl] 时 } 
CR NewlApp 
begin javadoc:wdDoInit 
六 va //@@beg doc:wdDoInit () 
[E Component Interfaces 7 2 esate 
dý Coniponorte /** Hook method called to initialize controller. */ 
"2 Dynp01Comp //@@end 
£ Component Controller public void Qee Eia () 
[@ Local Component Interface { 
$ Custom Controllers //@@begin wdDoInit () a 
@ Implemented Interfaces = 
@ € 
[E] Message Pool i //@@end 
@ Used Models bill } 
«<Â Used Components 
E Views //@@begin javadoc: wdDoExit () 
= sie /** Hook method called to clean up controller. */ 
£ Dynp02CompView A 
T Windows //@@end . : 
E Dynpo1compWindow 4 public void wdDoExit () a 
ef) NewlComp 4 © void comsap.demo.mydynpoLwd.comp.dynpolcomp.Dynp02CompViewwdDoExit0 
9 Dictionaries _ | ey SE E 
= E > | Problems| E Properties | B Snif Hook method called to clean up controller. 
= @ Documentation View =i pp 
tion yer = 
eave wt? 
ap * wdControllerAPI : IW ller a 
ap F wdComponentAPl : 1 
@ © Dynp02CompView(IP i CompView) | 
© wdDolnit0 : void) E 
© wdDoExit0 : void PT 
© wdDoModifyView(WDView, boolean) : void ~ 
— , m J r 
i i ca oa Iie beetles oom dee see i 


图 3-3 Java 编辑 器 中 的 初始 化 方法 


2) 在 wdDomit( ) 方 法 中 加 入 以 下 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess(" Init" ) ; 


3) 在 wdDoExit( ) 方 法 中 加 入 以 下 代码 : 


logger. infoT( " Exit" ) ; 


4) 在 wdDoModifyView 中 加 入 以 下 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess( " modifyView" ) ; 


5) 在 wdDoBeforeAction 中 加 入 以 下 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess( " BeforeAction" ) ; 


6) 完成 代码 工作 后 ， 需 要 对 程序 进行 编译 。 右 击 “Web Dynpro”, 
命令 ， 如 图 3-4 所 示 。 
在 弹出 的 快捷 菜单 中 选择 “Development Component” 


中 选择 “Development Component” 
7) 部 署 : 右 击 “Web Dynpro”, 


一 “Build” 


一 “Deploy” 命 令 ， 如 图 3-5 所 示 。 

8) 接着 et aE, Atk “Applications” 
单 中 选择 “Run”， 如 图 3-6 所 示 。 由 于 一 个 Web Dynpro 工程 允许 存在 一 个 或 多 个 程序 ， 
此 在 i 运行 时 需 正确 选择 程序 ， 同样 在 门户 创建 页 面 时 也 需要 注意 。 


中 的 应 用 程序 ， 在 到 


在 弹出 的 快捷 菜单 


出 的 快捷 荣 
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4 | [LocalDevelopment] mydynp01 | * this hook method. 
4 yi Web Dynpro New E 
Applicati 
4: B Applications Open Component Modeler 
EA mnolApp Rebuild Proj : 
CH NewlApp 昌 Rebuild Project view 
> 4È Models B, Build Project The view's generic API 
> [Bf Component Int z Le access to UI elements. 
Delet Delete à P 
À peere AEE TEN 2 firstTime 
4 np01Conl roject Archive Versions ž 
z Indicates whether the } 
gÈ Compon Deploy . A 5 
> [E Local Cd the lifetime of the viq 
Compare Metadata 
$< Custom 
@ Impleme ean 
图 Message Development Component » Show In > 
Repair » Synchronize 
B= Outline 5% Close Project & Build 
Open Project Deploy... 
出 comsap.demo.myd Properties Alt+Enter CIS PG Stes 
“= import declarations Enable Unit Test Support 
‘ 2CompVi & Remove from Context Ctrl+Alt+Shift+Down 
® Dynpo: j OMP A Migrate to Software Component | 
$F serialVersionUID : long 
BF Convert Project to Development Component... 
a?’ logger : Location s 
at} Configure Label Decoration... 
ap F wdThis : IPrivateDynp02CompView Log on 
ae. wdContext : IContextNode 


3-4 编译 Web Dynpro 项 目 


4] llocalDevelopment] mydyn Ne = , k method. 
4 $ Web Dynpro 
a 3 Applications Open Component Modeler 
ER Dyn01App Rebuild Project 
EF NewlApp Š |Build Project ew r : 
> @ Models Reload The view's generic API, a 
> Ig Component Interfaces se | Daisies Delete access to UI elements. 
C nt: ; 
À F Check Project Archive Versions rstTime 
4 ni ‘om . 
i Deploy Indicates whether the hog 
gÈ Component Co i : = 
> 因 Local compong re the lifetime of the view. 
$s Custom Control Team > 
@ Implemented In) Development Component » Show In A 
国 Message Pool 
Used Models Repair » Synchronize 
3 F = 
BE Outline 3 \_ @ Documentation oes totes ene 
Open Project Deploy... 
5 Update Project Settings 
出 com.sap.demo.mydynp01. Properties Alt+Enter ra 区 is 
rae i Enable Unit Test Support 
PO WS Remove from Context Ctrl+Alt+Shift+Down 
Dynp02CompView + Migrate to Software Component 
$F serialVersionUID : long Convert Project to Development Component... 
af? logger : Location Configure Label Decoration... 
mê {.} 
a F wdThis : IPrivateDynp02CompView Log on 
上 一 上 -一 一 


3-5 部 署 Web Dynpro 项目 


4 这 [LocalDevelopment] mydynp01 
a yi Web Dynpro 
4 & Applications 


EE 
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ER N 


D 


Open 


Open Data Modeler 


Record 
Delete 


Copy 


Deploy New Archive and Run 


Run 


Refactor 


Remove from Context 


图 3-6 


运行 应 用 程序 


9) 运行 后 ， 程 序 将 在 浏览 咒 中 自动 打开 ， 上 方 是 在 Web Dynpro 工程 视图 中 创建 的 按 
钮 ， 下 方 是 默认 的 消息 区 域 ， 如 图 3-7 所 示 。 


Init 
国 modifyview 


图 3-7 运行 后 的 效果 


10) 单 击 “Button” 按 钮 后 的 效果 如 图 3-8 所 示 。 


E BeforeAction 

国 itis wdThis:Button 

T] it is wdContext:NOdeElement(Dynp01Comp/Dynp02CompView.0) 
B it is ComponentAPiMessageManager(DYnp01Comp) 

Ø tis ControllerAPI:Button 

 modifyView 


T 


ch 


F “Button” 按钮 后 的 效果 


图 3-8 } 


从 执行 的 结果 可 以 看 出 ,初始化 先 打 印 了 wdDolInit 方法 中 的 消息 内 容 ， 然 后 打印 了 wd- 
DoModifyView 方法 中 的 消息 内 容 。 当 触发 Button Action 时 〈 即 单 击 按钮 时 ) ， 先 打印 wdDo- 
BeforeAction 方法 中 的 消息 内 容 ， 然 后 打印 Action 方法 中 的 消息 内 容 ， 最 后 打印 wdDoModify- 


View 方法 中 的 消息 内 容 。 
3.2.2 视图 的 描述 文件 与 标准 类 

在 Web Dynpro 中 ， 每 次 创建 一 个 视图 都 会 默认 生成 4 个 描述 文件 与 3 个 类 文件 。 图 3-9 
所 示 为 对 应 自动 生成 的 类 文件 ， 以 及 相互 之 间 的 继承 关系 ， 所 有 自 定义 代码 仪 在 视图 控制 器 
中 完成 ， 其 余 的 接口 、 实 现 类 都 会 自动 生成 。 其 他 相关 文件 还 包含 所 有 页 面 元 素 的 描述 文 
件 、 视 图 控制 絮 文 件 ， 以 及 多 语言 配置 的 .xf 文件 等 。 


继承 
= getComponentO 现 以 及 内 部 的 
* H SL HPH? 
Controller 控制 器 类 可 以 被 看 
wdGetAPIO 人 
wdControllerAPI 1 实现 wdControllerAPI 外 EREMIA] 


m 含 自 定义 代码 的 
控制 器 类 * 


图 3-9 视图 相关 类 以 及 相互 之 间 的 继承 关系 


View 
Controller 
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确切 地 说 ， 开 发 工具 在 创建 一 个 视图 之 后 会 在 文件 目录 中 自动 产生 7 个 文件 ， 开 发 人 员 
或 运 维 人 员 对 视图 的 任何 编辑 即 为 对 下 面 儿 个 文件 的 联动 修改 ， 而 所 有 视图 的 页 面 元 素 和 控 
制 逻辑 都 包含 在 对 应 的 文件 中 。 
e view: 视图 页 面 元 素 对 应 的 描述 记录 文件 。 
e | controller: 视图 控制 需 对 应 的 描述 记录 文件 。 
e .xlf: 用 于 多 语言 记录 的 语言 属性 文件 ， 通 过 对 该 文件 的 多 语言 复制 ， 可 以 实现 多 语 
言 的 场景 应 用 。 

e <NAME > View. java: 视图 对 应 的 后 台 处 理 类 ， 包含 视图 事件 处 理 ， 用 户 交互 所 包含 
的 业务 处 理 逻 辑 ， 开 发 及 运 维 人 员 重 点 关注 的 文件 。 

e [Private < NAME > View. java; 视图 中 wdThis 对 应 的 实例 接口 ， 包 含 所 有 的 视图 相关 
API 以 及 数据 结构 定义 ,代码 自动 生成 。 

e Internal < NAME > View. java; 实现 [Private < NAME > View 接口 ， 视 图 中 wdThis 所 指 
向 的 对 象 实例 ， 代 码 自 动 生成 。 

开发 实例 : 

1) 如 果 需 要 查看 视图 的 描述 文件 ， 则 进入 NWDS 的 Navigator 视图 (也 可 以 通过 Web 
Dynpro 视图 展开 resources 目录 )， 并 找到 对 应 工程 的 文件 夹 ， 如 图 3-10 所 示 。 

2) 在 “sre” 文 件 夹 下 ， 找 到 对 应 的 “Component” 文 件 夹 ， 文 件 夹 名 字 即 之 前 创建 的 
组 件 的 名 字 ， 如 图 3-11 所 示 。 


yA Web Dynpro Explorer (ep Search Console (is: Navigator x y 
4 § [LocalDevelopment] mydynp01 


| 
© bin 4 lS sre 


& cfg @ configuration 


b mimes 


© gen = 
£ gen_cmi 4 © packages 
@ gen_ddic 4 com 
{= gen_wdp 
@ lib s > sap 

© META-INF 4 & demo 


4 EE src 


42 dynp0l 
4\@ configuration > mycynp 
@ Applications 4 & wd 


i> app 
> @ Components id 
© mimes œc 


& Componentinterfaces 


@ packages 4 & comp 


图 3-10 ”导航 器 中 的 文件 目录 图 3-11 组 件 对 应 的 文件 目录 

3) 展开 “comp” 文 件 夹 ， 找 到 新 建 的 视图 所 对 应 的 几 个 文件 ， 如 图 3-12 所 示 。 

注 : 在 极 少 的 情况 下 ， 需 要 通过 这 种 方式 直接 修改 对 应 描述 文件 。 

4) 在 实际 的 Web Dynpro 工程 的 目录 中 ， 通 过 Navigator 定位 到 “gen_wdp” 目录， 如 
图 3-13 所 示 。 

5) 展开 “packages”， 定 位 到 “comp” 下 的 视图 ， 双 击 图 中 标注 的 “Dynpro02Comp View” 
类 ，( 见 图 3-14) ， 可 以 发 现 该 类 文件 与 双击 “Button” 按 钮 后 打开 的 类 文件 为 同一 文件 。 该 文件 
即 为 视图 对 应 的 后 台 Java 处 理 类 。 该 类 中 包含 了 所 有 视图 中 自 定义 的 业务 逻辑 单元 。 
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earch Console 


| 


a| aS 
=) Dynp01CompPlugWin.wdcontroller 

5 Dynp01CompPlugWin.wdnavigation 
Dynp0LCompPlugWin.wdwindow 
Dynp0LCompView.wdcontroller 
Dynp0LCompView.wdcontroller.xlf 
Dynp01LCompView.wdview 

@ Dynp01CompView.wdview.xlf 
Dynp01CompWindow_Window.mmdiagram 
Dynp01CompWindow.wdcontroller 
Dynp01CompWindow.wdnavigation 
Dynp01CompWindow.wdwindow 
Dynp02CompView.wdcontroller 
@ Dynp02CompView.wdcontroller.xlf 
Dynp02CompView.wdview 

@ Dynp02Com 


ll; 


DenDD 


oView.wdview.xlf 


图 图 


3-12 视图 对 应 的 实际 文件 


》 启 ' .settings 
> & bin 
S cfg 
& def 
4 @ gen 
4 © default 
> @ deploy 
> & logs 
buildresult.properties 
> f> gen_cmi 
> EE gen_ddic 
4 (> gen_wdp 
& configuration 
4 {> packages 
> 
@ lib 
& META-INF 
4@ src 


> & configuration 


> & mimes 


图 3-13 选择 “gen_wdp” 目 录 


6) 展开 “wdp” 目 录 ， 定 位 到 对 应 视图 的 类 文件 。 由 于 在 之 前 实例 中 创建 的 视图 名 称 
是 Dynp02CompView， 因 此 自动 产生 的 IPrivateDynp02CompView 为 相应 视图 控制 右 中 的 
wdThis 实例 接口 ，InternalDynp02CompView 为 外 部 使 用 的 类 文件 ， 如 图 3-15 所 示 。 


4 {> sap 
4 (= demo 
4 (> mydynp01 
4 (wd 
> & cd 
4 { comp 
4 {> dynp0lcomp 
> | wdp| 

J Dynp01Comp,java 
加 Dynp01CompView,java 


I Dynp01CompWindow,java 
加 Dynp02CompView,java 
> f= newlcomp 


@ lib 
& META-INF 
4@ sre 


4 守 wd 

> @ cid 

4 {= comp 

4 (> dynp0lcomp 
4 (© wdp| 

IConstantDynp01Comp.java 
IExternalDynp01Compinterface.java 
IMessageDynp01Comp,java 
InternalDynp01Comp,java 
InternalDynp01CompView.java 
InternalDynp0LCompWindow,java 
InternalDynp02CompView.java 


PrivateDynpU 


ompjava 
IPrivateDynp01CompView,java 
IPrivateDynp0LCompWindow.java 
IPrivateDynp02CompView,java 
IPublicDynp01Comp.java 
IPublicDynp01LCompWindow,java 

加 Dynp01LComp,java 

加 Dynp01CompViewjava 

加 Dynp01CompWindow,java 

加 Dynp02CompView,java 
> {> newlcomp 


3-14 ”视图 类 文件 的 目录 位 置 


图 3-15 ”相关 类 文件 的 目录 位 置 


25 


3.2.3 视图 的 上 下 文 


1. 上 下 文 的 定义 
Web Dynpro 中 的 Context 即 程序 的 上 下 文 。 在 Web Dynpro 工程 中 ， 除 了 接口 视图 控制 器 
以 外 的 所 有 控制 句 和 视图 都 有 一 个 存储 数据 的 多 级 结构 ， 而 这 就 是 Web Dynpro 中 的 上 下 文 。 
从 宏观 对 象 的 角度 理解 ， 上 下 文 可 以 看 作 视 图 对 象 对 应 的 逻辑 属性 ， 或 者 是 视图 对 象 的 
环境 变量 ， 所 有 前 端 页 面 的 数据 交互 都 会 通过 上 下 文 传递 到 对 应 的 控制 器 中 进行 逻辑 处 理 。 
另外 ， 它 还 有 以 下 几 个 特点 : 
© 所 有 上 下 文中 的 数据 仅 存在 于 控制 器 的 实例 中 ， 一 旦 实例 运行 结束 ， 上 下 文中 的 数据 
也 将 会 被 释放 。 
e 上下文 的 结构 是 在 开发 阶段 定义 的 ， 程 序 运 行 时 无 法 对 其 进行 任何 更 改 。 
e 视图 的 上 下 文 是 私有 的 ， 但 组 件 控制 器 的 上 下 文 可 以 通过 对 外 声明 进行 公开 ， 也 可 以 
进行 映射 ， 如 控制 器 与 视图 的 上 下 文 映 射 ， 控 制 器 与 模型 的 上 下 文 映 射 等 ， 这 也 是 
Web Dynpro 中 严格 进行 MVC 架构 的 一 个 体现 。 
从 底层 代码 的 分 析 可 以 发 现 ， 上 下 文 源 自 IPrivate < NAME > View 接口 的 静态 内 部 类 ， 
所 有 在 可 视 化 界面 中 对 上 下 文 的 操作 都 会 间接 地 去 修改 该 静态 类 ， 并 动态 地 生成 对 应 该 上 下 
文 数据 结构 的 操作 方法 。 假 设 创建 了 一 个 视图 ， 则 它 的 上 下 文 来 自 于 IPrivate < NAME > View 
接口 中 的 IContextNode 静态 类 。 下 面 通过 一 个 开发 实例 进行 进一步 讲解 和 验证 。 
开发 实例 : 
1) 切换 到 新 建 的 视图 ， 在 “Properties” 中 单 击 “Context”， 如 图 3-16 所 示 。 


ee 


[区 Problems | Œ Properties 器 [B Snippets | |] Infrastructure Console| 9) Error Log | 内 Tasks | imal 


B DynpO2CompView 


(General | Edit\View: 图 Context Properties © Context Mapping 


|_References 


Ci & YF E | Property Value 


© Context 


| Methods | 
| Event Handlers | 


| Actions 
| 


— 


图 3-16 h “Context” 


jE: 在 NetWeaver 7.0 及 其 之 前 版 本 的 开发 工 ER Jone 
AP, EFÈ Context 的 定义 在 与 布局 “Layout” | References ,|G_ troue | 
并 列 的 “Context” 中 ， 然 而 在 新 版 本 的 开发 工具 Binding Chain 


中 ， 上 下 文 、 方法 、 事件 处 理 器 等 容 统 一 被 包含 3 Copy Ctrl+C OA 

在 “Properties” 选 项 卡 下 。 ar geste sce 
2 ) 右 击 “ Context” A 在 弹 出 的 快捷 菜单 中 选 X Delete Delete 

择 “New” 一 “Attribute” 命 令 ， 创 建新 特性 ， 如 histor 2 |, 

| 3-17 所 示 。 ee A | propery 


3) 选择 自 定 义 创 建 ， 然 后 输入 特性 名 称 并 选 m 
择 特性 的 类 型 。 选 中 “Manually” 单 选 按钮 进行 手 
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动 创建 ， 并 输入 “name"， 选 择 “shing” 字 符 串 类 型 ， 如 图 3-18 所 示 。 
后 Context Attribute i "ner -E-E 


Create a context attribute a 


Specify whether you want to create the element manually or with context mapping, @ 
model binding or structure binding 


Create With 
© Mapping 
Model Binding 
Structure Binding 
@ Manually 


Calculated 


3-18 输入 特性 名 称 并 选择 特性 类 型 


4) 验证 上 下 文 在 Java 源 文 件 中 定义 。 切 换 到 IPrivateDynp02CompView 类 ， 通 过 
Outline 方法 清单 或 按 (Ctrl +0) 组合 键 找到 IContextElement 静态 类 ， 可 以 看 到 刚才 新 
建 的 属性 对 应 的 静态 对 象 声 明 ( 见 图 3-19) 以 及 get 和 set 赋值 方法 都 已 自动 创建 完毕 
( 见 图 3-20)。 


E Dynp02CompView 
= [** 
* Interface for the elements of the node Context. 
*/ 


© public static class} IContextElement extends com.sap.tc.webdynpro.pro 


{ 
private static final long serialVersionUID = 0x9f918d6ff6b189Ff9L; 


加 Dynp02CompViewjava | [J] InternalDynp02CompView,java 


private InternalDynp02CompView gen_delegate; 


Ə IContextElement (InternalDynp02CompView delegate, com.sap.tc.webdyn] 
super (info); 
gen_delegate = delegate; 

} 


// attribute "name" 


= [** 
* Returns the attribute name. 
*/ 
© public java.lang.String getName() { 


at Tm ] 


BS 


3-19 ”静态 对 象 声 明 


5) 通过 代码 对 Context 进行 赋值 ， 右 击 对 应 的 视图 ， 选 择 打 开 Java 编辑 器 ， 如 图 3-12 
所 示 。 
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public final static String NAME = "name"; 


[** 

* Returns the attribute name. 

af 

public java.lang.String] getName() { 
return gciGetString (0}; 

} 

/大大 


* Sets the attribute name. 

* @param value the new value 

*/ 

public void setName(java.lang.String value) { 
gciSetString(0, value); 


} 


图 3-20 自动 创建 的 方法 


Open » View Editor and Java Editor 
X Delete Delete View Editor 
Copy Ctrl+C Java Editor 


Repair 


Convert to Flash View 


w 


Apply Template... 
Refactor 上 


e Console | E Properties 8 = Deplq 


Remove from Context Ctrl+Alt+Shift+Down 


图 3-21 打开 Java 编辑 器 


6) 找到 视图 初始 化 的 默认 “wdDomit” 方 法 ， 并 加 入 以 下 赋值 代码 : 


public void wdDoInit( ) 
| 
//@ @ begin wdDolnit( ) 
// 将 默认 Context 元 素 中 的 name 属性 的 值 设 为 “ 王 明 ” 
wdContext. currentContextElement( ). setName(" 王 明 " ) ; 
//@ @ end 


| 


7) 找到 “onActionButton” 方 法 ， 给 之 前 的 代码 加 上 注释 并 加 入 以 下 代码 . 
// 将 默认 Context 元 素 中 的 name 属性 的 值 取出 并 赋 给 name 变量 


String name = wdContext. currentContextElement( ). getName( ) ; 
// 将 name 变量 以 成 功 消息 形式 打印 出 来 


wdComponentAPI. getMessageManager( ). reportSuccess( name ) ; 


8) 保存 所 有 修改 ， 重 新 编译 运行 之 后 ， 即 可 进行 
相关 测试 。 单 击 “Button” 按 钮 可 以 看 到 打印 出 的 
“name” 特性 的 信息 ， 如 图 3-22 所 示 。 由 于 是 成 功 类 型 


的 消息 ， 因 此 文本 前 有 一 个 绿色 的 感叹 号 。 : — 
2、 上 下 文 的 属性 图 3-22 程序 运行 效果 


由 于 上 下 文 是 可 分 级 的 数据 ， 因 此 不 管 是 上 下 文 的 结 点 或 者 特性 ， 都 可 以 对 它们 的 属性 
进行 进一步 的 配置 。 下 面 通过 上 一 节 创 建 的 实例 进行 进一步 说 明 。 
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(1) 特性 的 属性 
打开 页 面 的 “属性 ”选项 卡 ， 找 到 刚才 创建 的 name 特性 ， 单 击 选中 后 ， 可 以 看 到 右边 
还 有 相关 的 属性 可 以 进行 配置 ， 如 图 3-23 所 示 特 性 的 属性 名 称 及 说 明 见 表 3-1。 


Edit\View: @ Context Properties | 


Context Mapping 


ó g T E 


Property 


4 © Context 
B name 


Calculation 


Calculated 

Misc 
Name 
Read-Only 
Semantic ID 
Structure Element 


Type 


图 3-23 ”特性 的 属性 配置 


表 3-1 特性 的 属性 名 称 及 说 明 


Value 


string 


属性 名 称 说 明 
Calculated 是 否 可 计算 (如 为 tue, 将 自动 生成 对 应 的 计算 方法 对 特性 进行 初始 化 ) 
Name 特性 的 名 称 


Read - Only 


ERRE, 


属性 与 Calculated 


属性 相关 ， 设 置 为 true AY, Calculated 


属性 没有 setter 方法 


Semantic ID 


语义 ID， 很 少 


使 用 


Structure Element 


了 结 点 和 特性 两 种 类 型 ) ， 所 以 它 也 可 以 看 作 一 个 集合 ， 


Type 


(2) 结 点 的 


类 型 ， 


属性 


对 应 的 特定 结构 的 数据 类 型 ， 很 少 使 
可 通过 下 拉 菜 单 选 择 简单 类 型 
的 按钮 选择 其 他 复杂 类 型 (包括 本 地 数 


中 的 


自 定义 类 型 ) 


KAI), ， 也 可 通过 单元 格 右 侧 


EFX Context 中 的 结 点 是 存放 Web Dynpro 数据 的 一 个 虚拟 类 ， 它 允许 有 子 绪 点 (包含 


可 以 想象 是 一 个 表格 或 者 树 的 根 结 


点 。 结 点 属性 名 称 及 说 明 见 表 3-2。 
R3-2 结 点 的 属性 名 称 及 说 明 
属性 名 称 说 明 
Collection Cardinality 结 点 的 集合 属性 
Initialize lead Selection 是 否 初始 化 首选 项 ( 如 在 表格 中 有 默认 选中 行 ) 
Name 结 点 的 名 称 
Selection Cardinality 选择 的 集合 属性 
Singleton 是 否 单 例 (通用 设计 模式 的 一 种 ) 
ee 结 点 的 创建 可 以 基于 任意 数据 结构 ， 对 于 通过 模型 绑 定 或 者 自 定义 的 结构 类 
型 建立 的 结 点 ， 该 处 显示 结构 名 称 
SupplyFunction 提供 对 结 点 填充 的 处 理 方法 


下 面 对 结 点 的 集合 属性 和 选择 的 集合 属性 中 的 下 拉 列 表 的 选项 进行 说 明 。 
1) Collection Cardinality 中 ; 


QD 0..1 代表 node 集合 长 度 为 1， 默 认 集 合 为 空 ， 


可 以 添加 一 个 实例 。 
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@) 0..n 代表 node 集合 长 度 为 na， 默 认 集合 为 空 ， 可 以 添加 mn 个 实例 。 

(3) 1..1 代表 node 集合 长 度 为 1， 初 始 化 默认 一 个 实例 ， 不 可 以 再 次 添加 实例 。 
@ 1..n 代表 node AKEN n, 初始化 默认 一 个 实例 ， 可 以 添加 n 个 实例 。 
2) Selection Cardinality 中 : 

O0..1 代表 最 多 一 条 的 选中 ， 默 认 没有 选中 条 目 。 

Q0..n RRRS n 条 的 选中 ， 默 认 没 有 选中 条 目 。 

@) 1.. 1 代表 最 多 一 条 的 选中 ， 默 认 一 条 选中 。 

(@ 1..n 代表 最 多 n 条 的 选中 ， 默 认 n 条 选中 。 


开发 实例 : 
1) 右 击 Context， 在 弹出 的 快捷 菜单 中 选择 “New”-，“Node” 命 令 ， 新 建 一 个 结 点 ， 


如 图 3-24 所 示 。 


ne | Node- 


Binding Chain 
G Copy Ctrl+C 
Paste Ctrl+V 


Paste Special... 


g X Delete Delete sole| @] Error Log | Ž Tas 
Rename... F2 


Expand Subtree 


| Show Help 


器 


3-24 新 建 一 个 结 点 


2) 输入 结 点 名 称 “Per”， 单 击 “ Finish” 按 钮 ， 如 图 3-25 所 示 。 


E Context Node | el T) 


Create a context node _ 
| Specify whether you want to create the element manually or with context mapping, 
model binding or structure binding 
Create With 
Mapping 
Medel Binding 
» Structure Binding 


| 


图 3-25 输入 结 点 名 称 


3) 接着 验证 Context 在 Java 文件 中 的 定义 : 在 保存 好 上 述 修 改 后 ,切换 到 “TInternal 
Dynp02CompView” 类 ， 可 以 看 到 静态 语句 块 中 自动 生成 了 对 刚才 新 建 node 的 初始 化 代码 如 
图 3-26 所 示 。 其 中 参数 中 的 CMICardinality 分 别 对 应 于 结 点 的 集合 属性 和 可 选 属性 。 
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Dynp02CompView | InternalDynp02CompViewjava TON 回 IPrivateDynp02CompView.java 司 
ff er. "COU J er ae 


IGCINodeInfo infoPer; 
IGCINodeInfo infoContext; 


{ 


infoPer = GCIContext.createValueNode("Per", true, CMICardinality.ZERO TO ONE, CMICardinality.ZERO TO ONE, true, null, 
(IGCIAttributeInfo[])null, // no attributes 

(IGCINodeInfo[])null // no child nodes| 

de 


infoContext = GCIContext.createValueNode("Context", true, CMICardinality.ONE, CMICardinality.ONE, true, null, 
new IGCIAttributeInfo[] { 
GcIContext.createAttribute("name", "ddic:com.sap.dictionary.string", null, null, false, null), 


br 
new IGCINodeInfo[] { 
infoPer, 
} 
ve 


图 3-26 自动 生成 代码 定义 
4) 打开 页 面 的 “属性 ”选项 卡 ， 找 到 刚才 创建 的 “Per” 结 点 ， 单 击 选中 后 ， 可 以 看 
到 右边 还 有 相关 的 属性 可 以 进行 配置 ， 如 图 3-27 所 示 。 
5) 通过 代码 对 结 点 中 的 特性 进行 赋值 。 在 “Per” 结 点 中 新 建 一 个 名 称 为 “id” 的 特 
性 ， 如 图 3-28 所 示 。 


Property 
Documentation 
Quick info 
Technical Documentation 
Misc 
Collection Cardinality 0..n 
Initialize Lead Selection true 


Name Per 
Selection Cardinality 0..1 


Singleton true 4 O Context 
Structure 


Supply Function 4 


Typed Access Required true 


D name 


图 3-27 4S ie 


HT 


图 3-28 新 建 一 个 名 称 为 “id” 的 特性 
6) 作为 测试 用 例 , 将 “Per” 结 点 的 集合 属性 修改 为 “0.. 1”， 如 图 3-29 所 示 。 


Edit\View: @ Context Properties © Context Mapping 
C8 YF © | Property Value 
4 © Context | 4 Documentation 
4 Per Quick info 
Ð id | Technical Documentation 
B name | 4 Misc 
| 
Initialize Lead Selection false 
Name Per 
Selection Cardinality 0.1 
| Singleton true 
Structure 
Supply Function 
Typed Access Required true 


EE 


3-29 结 点 属性 示例 
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7) 切换 到 视图 的 “wdDomit” 初 始 化 方法 ， 加 入 以 下 代码 : 


wdComponentAPI. getMessageManager( ) . reportSuccess ( " PerNode Size:" + wdContext. nodePer ( ) 
. size( ) ) ;// 打 印 结 点 的 大 小 

IPerElement createAndAddPerElement = wdContext. nodePer ( ) . createAndAddPerElement ( ) ;// 添 
加 Element 

createAndAddPerElement. setld( "12" ) ; 

wdComponentAPI. getMessageManager( ) . reportSuccess ( " PerNode Size:" + wdContext. nodePer ( ) 
. size( ) ) ;// 打 印 添 加 Element 后 node size 


8) 进入 “Button” 按 钮 的 动作 处 理 逻 辑 中 ， 并 加 入 以 下 代码 


messageManager. reportSuccess( wdContext. nodePer( ). currentPerElement( ). getld( ) ) ; 


//[ 打 印 当前 选中 (默认 选中 ) Element 的 Id 变量 值 


9) 与 之 前 同样 地 进行 编译 部 署 ， 在 运行 之 后 ， 单 击 “Button” 按 钮 ， 如 图 3-30 
所 示 。 
10) 接着 单 击 “Button” 按 钮 ， 打 印 出 添加 的 特性 值 。 


PerNode Size:0 
PerNode Size:1 ld Value Method1:12 


3-30 ”运行 效果 3-31 单 击 按钮 后 的 效果 

(3) 特性 的 可 计算 属性 

特性 的 属性 中 的 Calculated 比较 特别 ， 除 了 true 或 者 false 的 选择 外 ， 还 涉及 代码 编写 ， 
所 以 在 此 单独 进行 说 明 与 开发 实例 展示 。 该 属性 设置 为 rue 时 ,代表 可 以 自 定义 特性 值 的 
获取 逻辑 ， 从 字面 理解 来 看 也 就 是 可 以 计算 的 意思 ,， 并 且 在 对 应 的 类 中 会 生成 对 应 的 getter 
方法 。 

开发 实例 : 确认 自动 生成 的 公共 方法 及 其 调用 逻辑 

1) 切换 到 视图 的 上 下 文 界 面 ， 将 “Per” 结 点 下 的 “id” 特 性 的 Calculated 属性 设置 为 
“true”， 如 图 3-32 所 示 。 根 据 上 下 文 类 定义 的 介绍 ， 依 次 查看 视图 控制 器 Dynp02Comp 
View. java、 公 共 接 口 InternalDynp02CompView. java 和 实现 类 IPrivateDynp02 CompView. java 3 
个 java 文件 中 自动 生成 的 代码 。 


pView 
óo g T B Property Value 
4 © Context Calculation 
4 Per Buffer Mode Unbuffered 
Calculated true 
D name Calculated Getter getPerld 
Misc 

Name id 
Read-Only true 
Semantic ID 
Structure Element 
Type string 


N 


3-32 ”特性 的 属性 
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2) AF “Calculated Getter” 中 “getPerId” 最 右 侧 的 “Go” 按 钮 ,界面 将 自动 跳 转 到 
Dynp02CompView. java 中 生成 的 getPerld ( ) 公共 方法 ( 见 图 3-33)， 传人 参数 element 是 
“Per” 结 点 的 实例 元 素 。 


Dynp02CompView j [J] InternalDynp02CompViewjava [J] IPrivateDynp02CompView.java 
R94 //@@begin javadoc:getPerId 

2950 /** 

R96 * Declared getter method for attribute id of node Per. 

p97 * 

p98 * @param element the element requested for the value 

p99 * @return the calculated value for attribute id 

Boo */ 


BOL //@@end 
B029 fpublic java.lang.String AJS (IPrivateDynp02CompView.IPerElement element) 


B03 { 

BO4 //@@begin getPerId 
BOS return null; 

BOG //@@end 

B07 

Bos 


图 3-33 自动 生成 的 代码 1 
3) 进入 PnternalDynp02CompView. java， 同 样 看 到 生成 了 getPerld( ) 方 法 (LAI 3-34), 
内 部 实现 为 调用 Dynp02CompView 实例 的 方法 。 


2CompView | 加 Dynp02CompView.java j [J] IPrivateDynp02CompView.java 
public void method _Fill_DropDownWithProposalList( com.sap.typeservices.IProposalLis 
delegate.method_Fill_ DropDownWithProposalList( proposalList); 


} 


public void method_Fill_ FieldProposalList_i( ) { 
delegate.method_ Fill FieldProposalList_i(); 


java.lang.String result = delegate.getPerId(element) ; 


return result; 


图 3-34 自动 生成 的 代码 2 
4) 进入 IPrivateDynp02CompView. java， 定 位 到 IPerElement 内 部 类 ， 看 到 wdGetCalculat- 
ed( ) 方 法 中 添加 了 执行 InternalDynp02CompView 实例 中 getPerld( ) 方 法 的 代码 ， 如 图 3-35 
所 示 。 由 于 InternalDynp02CompView 中 getPerld( ) 方 法 执行 Dynp02CompView 中 getPerld( ) i# 
辑 ， 因 此 最 终 是 执行 了 视图 控制 器 中 的 自 定 义 代码 。 


ompView Ti) Dynp02CompViewjava 四 InternalDynp02CompViewjava 
* @param value the new value 
*/ 
public void setId(java.lang.String value) { 
gciSetString(0, value); 
} 


switch (info.getIndex()) { 
case 0: // id 
return gen_delegate.getPerId(this) ; 


} 
return null;| 


图 3-35 自动 生成 的 代码 3 
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开发 人 员 一 般 关 注视 图 控制 器 的 java 文件 即 可 ， 如 Dynp02Comp View. java， 而 接口 类 和 
实现 类 的 代码 都 会 自动 生成 。 

开发 实例 : 验证 getter 方法 的 执行 时 间 与 执行 顺序 

1) 切换 到 Dynp02CompView 类 中 的 getPerld( ) 方 法 〈 见 图 3-36) ， 并 添加 以 下 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess(" Execute getPerld Method" ) ; 


E] Dynp02CompView |W Dynp02CompView, 539 [J) InternalDynpO2CompView,java (J) IPrivateDynp02CompView,java 


//@@begin javadoc:getPerId 
/x 
Declared getter method for attribute id of node Per. 


DAWN 


@param element 
the element requested for the value 
@return the calculated value for attribute id 
*/ 
//@@end 
public java.lang.String getPerId(IPrivateDynp02CompView.IPerElement element) 


O WW WO WO OO WO 
由 Do ~ 


© 


A 
2 
E> 
2 
2 
ip 
2 
p] 
2 
2 
p) 
i2 
2 
3 


in getPerīId 


3-36 添加 自 定 义 代码 


2) 修改 node Per 的 集合 属性 为 1..1、Initialize Lead Selection X true ( 见 图 3-37) ， 同 
时 注释 掉 wdDolInit( ) 中 的 代码 ， 进 入 Button Action 并 修改 为 以 下 代码 : 


messageManager. reportSuccess( "Id Value Method] ;" + 
wdContext. nodePer( ). currentPerElement( ). getId( ) ) ; 


| 区 Problems |=) Properties 3 > [E Snippets | [E] Infrastructure Console | ©) Error Log| Z) Tasks! 
国 Dynp02CompView 


General Edit\View: @ Context Properties © Context Mapping 


References Ci g FF © | Property 


4 © Context Documentation 
> o Per | Quick info 


Event Handlers B name Technical Documentation 
Misc 
Collection Cardinality 1.1 


Initialize Lead Selection true 


Miscellaneous Name Der 


Selection Cardinality 0..1 
Singleton true 


3) 保存 所 有 修改 ,并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效果 如 图 3-38 
所 示 。 
单 击 “Button” 按 钮 ， 可 以 看 到 先 打 印 Execute 语句 后 打印 Id Value， 系 统 在 执行 current 
* Element. getId( ) 方 法 前 ， 执 行 了 getPerld( ) 方 法 ， 并且 最 终 Id 的 数据 源 来 自 getPerld 代码 
逻辑 。 由 于 getPerld( ) 返 回 为 null， 因 此 打印 的 Id 值 为 null。 
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3-37 结 点 属性 设置 


Execute getPerld Method1373971234180 
id Value Method1:null 


Al3-38 ”运行 效果 1 


4) 修改 getPerId( ) 代 码 逻 辑 ， 保 存 所 有 修改 ， 并 重新 编译 ， 运 行 之 后 ， 即 可 进行 相关 
测试 。 


wdComponentAPI. getMessageManager( ). reportSuccess(" Execute 
getPerld Method" + System. currentTimeMillis( ) ) ; 
return "element Of Id Attribute;" + element +" :abc'" ; 


5) 单 击 “Button” 按 钮 ， 程 序 返 回 了 Id 所 属 的 当前 Element 索引 以 及 自 定义 的 拼接 字 
符 串 ， 如 图 3-39 所 示 。 


Execute getPerld Method1373971828418 
ld Value Method1:element 01 Id Attribute:NodeElement(Dynp01Comp/Dynp02CompView .Per.0):abc 


图 3-39 ”运行 效果 2 


3. 上 下 文 的 相关 API 及 常用 方法 
1. IContextNode 上 下 文 默 认 结 点 相关 公共 方法 


切换 到 IPrivate < NAME > View， 定位 到 a 加 5 IContextNode «| 
F cert . hac 
内 部 类 IContextNode 的 公 J 共 方 法 ， 如 图 3-40 FF serialVersionUID : long 
a gen_delegate : InternalDynp02CompView 
所 示 o a © IContextNode(InternalDynp02CompView, IGI __ 
1 ) createContextElement ( ) : ill 建 一 个 © createNode(IGCINodelnfo, Node, NodeElen 


Pa Ca ementtio NodsInio Object) : N' 
wdGetAPIN : IWDContext 

createContextElement( : IContextElement 
createAndAddContextElement() : [ContextEle 
bind(iContextElement) : void 


KG FIA EPSCoR (element), ， 但 结 点 
Aa 间 回 该 元 素 的 引用 ， 即 无 法 在 
结 点 中 找到 该 元 素 ， 需 要 在 代码 中 另外 对 结 
点 的 实例 执行 add 方法 进行 添加 ， 所 以 一 般 
使 用 下 面 的 createAndAdd 方法 。 

2) createAndAddContextElement( ) : 创 
建 一 个 上 下 文 元 素 并 添加 至 对 应 的 结 点 实例 | Ne cate 
中 ， 即 结 点 的 集合 属性 的 大 小 增加 了 , 并且 [b O: iperNode -| 
可 以 通过 getElement( ) 方 法 或 currentElement 
方法 (当前 元 素 ) 获取 该 条 Element 的 索引 。 图 3-40 定位 到 内 部 类 IContextNode 的 公共 方法 
TE: 集合 属性 为 “1..1” 的 结 点 不 允许 执行 createAndAddElment( ) 方法， 因为 这 样 的 结 点 有 
且 仅 有 一 个 元 素 。 

3) currentContextElement(): 获取 当前 首选 (Lead Selection) 的 元 素 ， 只 有 结 点 存在 
首选 元 素 时 ， 该 方法 才能 获取 对 应 的 元 素 ， 以 下 为 currentContextElement 在 不 同属 性 下 的 获 
取 值 情况 

当 Initial Lead Selection W false 时 ， 并 且 结 点 在 没有 Lead Selected 的 情况 下 ，currentCon- 
textElement 始终 返回 为 空 


currentContextElement() : IContextElement 
nodePer() : IPerNode 

currentPerElement0 : [PerElement 
createPerElement( : [PerElement 
createAndAddPerElement( : [PerElement 


© © © © © o olojo 
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当 Initial Lead Selection X false 时 ， 并 且 结 点 在 有 Lead Selected 的 情况 下 , currentContex- 
tElement 返回 当前 已 选中 的 元 素 。 

当 Initial Lead Selection X true 时 ， 并 且 结 点 在 没有 Lead Selected 的 情况 下 ， 始 终 返 回 第 
一 条 元 素 。 

Node < NAME > ( ) : 获取 < NAME > 名 称 的 子 结 点 的 引用 。 

current < NAME > Element( ) : 返回 < NAME > 名 称 的 子 结 点 对 应 的 当前 元 素 。 

create < NAME > Element( ) : 创建 一 个 < NAME > 名 称 的 子 结 点 的 元 素 。 

createAndAdd < NAME > Element( ) : 创建 一 个 < NAME > 名 称 的 子 结 点 的 元 素 ， 并 将 
引用 添加 至 子 结 点 中 。 

2. IContextElement 上 下 文 默认 结 点 元 素 的 相关 公共 方法 

1) get <NAME > ( ) : IContextElement 下 定义 的 特性 get 方法 ， 获 取 < NAME > 名 称 的 
特性 值 。 

2) set <NAME > ( ) : IContextElement 下 定义 的 特性 set 方法 , 设置 <NAME > 名 称 的 特 
性 值 。 

3. I<NAME > Node 自 定义 结 点 的 相关 公共 方法 

1) current < NAME > Element( ) : 同 IContextNode， 返 回 < NAME > 名 称 的 子 结 点 对 应 
的 当前 元 素 。 

2) create < NAME > Element( ) : |F] IContextNode， 创 建 一 个 <NAME > 名 称 的 子 结 点 
的 元 素 。 

3) createAndAdd < NAME > Element( ) : |F] IContextNode， 创 建 一 个 <NAME > 名 称 的 
子 结 点 的 元 素 ， 并 将 引用 添加 至 子 结 点 中 。 

4) get < NAME > ElementAt( ) : 该 方法 针对 集合 属性 为 0..n 或 1..n 的 结 点 ， 获 取 指 
定 索引 的 元 素 。 

4. I<NAME > Element 自 定义 < NAME > 结 点 元 素 (可 以 看 作 <NAME > 结 点 的 实 
例 ) 的 相关 公共 方法 ( 见 图 3-41) 

1) get <NAME >(): |E] [ContextEle- 
ment， 获 取 < NAME > 名 称 的 特性 值 。 


一 ， 


o& Outline £3 @ Documentation View 


PLRO 


4/0" TPerElement 
2) set < NAME > ( ): 同 IContextEle- $F serialVersionUID : long 
ment, 设置 < NAME > 名 称 的 特性 值 。 a : seen i ee 
Sy a erElement(InternalDynp' ompView, 
以 上 整体 介绍 了 默认 上 下 文 的 ICon- $F ID : String 
textNode 、IContextElement 以 及 自 定 义 结 点 © getld0 : String 
HJ I< NAME > Node, I < NAME > Element a 
$ Ae © wdGetContext() : IContextNode 
的 相关 API 的 说 明 。 而 从 IContextNode 的 © method_Fill FieldProposalListQ : void 


初始 化 方法 可 以 看 到 ,该 Node 其 实 是 集 
合 属性 为 1..1， 并 且 选 择 属性 也 为 1..1 
的 结 点 ， 因 此 通常 把 它 叫 作 根 结 点 ， 可 以 在 根 结 点 的 基础 上 去 构造 符合 个 性 化 需求 的 结构 化 
上 下 文 ， 并且 这 些 数据 结构 会 在 IPrivate < NAME > View 的 内 部 类 中 自动 生成 对 应 的 公共 方 
法 。 当 然 这 些 新 的 内 部 类 以 及 类 方法 同样 遵循 上 述 的 规则 ， 并 以 此 类 推 控制 整个 上 下 文 及 其 
结构 。 

从 Web Dynpro 开发 组 件 的 角度 来 理解 ，Context 是 具体 某 一 DC 组 件 的 上 下 文 ， 通 过 对 
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图 3-41 结 点 元 素 相关 公共 方法 


上 下 文 的 操作 来 实现 对 整个 组 件 的 属性 控制 。 上 下 文中 所 有 结 点 结构 都 对 应 于 后 台 的 内 部 
类 ， 并 且 针 对 内 部 类 有 对 应 的 构造 与 操作 变量 的 方法 。 

开发 实例 : 

(1) 上 下 文 属性 实例 1 

1) 修改 “Per” 结 点 的 集合 属性 为 “0..1”， 同 时 修改 Initial Lead Selection 属性 为 
“false”， 如 图 3-42 所 示 。 


Edit\View: @ Context Properties © Context Mapping 
oe T E | Property Value 
4 ©) Context | Documentation 
> [DO Per| | Quick info 
日 name | Technical Documentatior 
Misc 
| ollection Cardinality 0.. 
| 
Name Per 


器 


3-42 ”设置 结 点 属性 


2) 切换 到 wdDolInit( ) 方 法 ,保留 以 下 代码 ( 见 图 3-43): 


wdComponentAPI. getMessageManager( ) . reportSuccess ( " PerNode Size:" + wdContext. nodePer( ) 
. size( ) ) ; 

IPerElement createAndAddPerElement = wdContext. nodePer( ). createAndAddPerElement( ) ; 
createAndAddPerElement. setld( "12" ) ; 

wdComponentAPI. getMessageManager( ) . reportSuccess ( " PerNode Size:" + wdContext. nodePer ( ) 


. size( ) ); 


public void wdDoInit() 
{ 
//@@begin wdDoInit () 


// wdComponentAPI. SotvessageManager() EE Init"); 


wdComponentAPT . GetlasdaqeManager , pepertsuecess ( 
"PerNode Size:" + wdContext.nodePer().size()); 

IPerElement createAndAddPerElement = wdContext.nodePer() 
- createAndAddPerElement () ; 

createAndAddPerElement.setId("12"); 


// createAndAddPerElement 4 

// wdContext.nodePer () .createAndAddPerElement () ; 

// createAndAddPerElement.setId("13"); 

wdComponant API. getMessageManager () .reportSuccess (人 
"PerNode Size:" + wdContext.nodePer().size()); 


//@@end 
} 


3-43 ”代码 修改 


3) 双击 “Button” 按 钮 ， 进 入 按钮 事件 的 逻辑 处 理 ， 并 保留 以 下 代码 ( 见 图 3-44): 


TWDMessageManager messageManager = wdComponentAPI. getMessageManager( ) ; 
messageManager. reportSuccess("Id Value Method] ;" +wdContext. nodePer( ). currentPerElement( ) ) ; 
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public void onActionButton(com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 
{ 
//@@begin onActionButton (ServerEvent) 
IWDMessageManager messageManager = wdComponentAPI.getMessageManager (); 
// messageManager.reportSuccess("It is wdThis:" 
// + wdThis.wdGetButtonAction().getText()); 
// messageManager.reportSuccess ("It is wdContext:" 
// + wdContext.currentContextElement ()); 
// messageManager.reportSuccess ("It is ComponentAPI:" 
// + wdComponentAPI.getMessageManager ()); 
// messageManager.reportSuccess ("It is ControllerAPI:" 
// + wdControllerAPI.getAction ("Button") .getText()); 
// logger.errorT("It is Logger Error!:"); 
// String name = wdContext.currentContextElement () .getName (); 
// messageManager.reportSuccess (name) ; 
messageManager.reportSuccess ("Id Value Methodl: 
+ wdContext .nodePer () .currentPerElement|())) ; 


// messageManager 

// .reportSuccess("Id Value Method2:" 

// + ((IPerElement) (wdContext.nodePer().getElementAt (0))) 
// ys 


// Modal Window 
// Confirmation Dialog 
//@@end 
} 


器 


3-44 ”代码 修改 


4) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 3-45 所 示 。 
5) 单 击 “Button” 按 钮 进行 测试 ， 运 行 效果 如 图 3-46 所 示 。 


PerNode Size:0 


PerNode Size:1 ld Value Method1:null 


BS 
no 


3-46 ZITA 


图 3-45 初始 化 运行 效果 


可 以 看 到 打印 的 Message 为 null， 即 currentPerElement( ) 方 法 获取 的 是 Lead Selection 的 
条 目 ， 当 Lead Selection 为 false 时 ， 该 方法 返回 的 是 空 指针 。 

(2) 上 下 文 属性 实例 2 

1) 切换 到 Context 视图 ,设置 node Per 的 Initialize Lead Selection 属性 为 “true”， 如 
图 3-47 所 示 。 


Edit\View: @ Context Properties © Context Mapping 


Ge | Property Value 
4 Documentation 
Quick info 
Technical Documentatior 
4 Misc 


Collection Cardinality 0..1 


图 3-47 设置 结 点 属性 


2) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 单 击 “Button” 按 钮 ， 
运行 效果 如 图 3-48 所 示 。 

从 上 面 的 结果 可 以 看 到 ，currentPerElement( ) 返回 的 值 不 为 空 ， 修 改 打 印 的 代码 可 以 打 
印 出 currentElement 的 Id 属性 值 。 
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Id Value Method1 :NodeElement(Dynp01Comp/Dynp02CompView .Per.0) 


3-48 ”运行 效果 
(3) 上 下 文 属性 实例 3 
1) 切换 到 Context 视图 ， 修 改 “Per” 结 点 的 集合 属性 为 “0..n”、Initialize Lead Selec- 
tion BEX “fase”, 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 
图 3-49 所 示 。 


Edit\View: @ Context Properties © Context Mapping 


Ci & F & | Property Value 
4 © Context 4 Documentation 
> Q Per Quick info 
D name Technical Documentatior 
4 Misc 


3-49 设置 结 点 属性 


2) 单 击 “Button” 按 钮 就 能 看 到 对 应 的 提醒 消息 ，current < NAME > Element ( ) 返回 的 
为 空 ， 如 图 3-50 所 示 。 


id Value Method1:null 


Al3-50 Xi “Button” 按钮 后 的 运行 效果 


(4) 上 下 文 属性 实例 4 
1) 再 次 修改 Initialize lead Selection 为 “true”， 保 存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 


即 可 进行 相关 测试 ， 如 图 3-51 所 示 。 
Edit\View: @ Context Properties D Context Mapping 
Co & fF E | Property Value 
a © Context Documentation 
> A Per| Quick info 
name Technical Documentation 
Mise 
Collection Cardinality 0n 
Name Per 


3-51 设置 结 点 属性 


2) 单 击 “Button” 按 钮 ， 可 以 看 到 currentElement 返回 的 不 为 空 ， 同 时 指向 了 对 node 
第 一 条 Element 的 引用 ， 如 图 3-52 所 示 。 

3) 切换 到 OutLine 视图 ， 右 击 “RootElement”， 在 弹出 的 快捷 菜单 中 选择 “Apply Tem- 
plate”， 选 项 ， 如 图 3-53 所 示 。 

4) 在 弹出 的 对 话 框 中 选中 “Table” 类 型 ， 单 击 “Next” 按 钮 ， 如 图 3-54 所 示 。 
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Id Value Method1 :NodeElement(Dynp01Comp/Dynp02CompView.Per.0) | 


图 3-52 Hi “Button” 按钮 后 的 运行 效果 


Insert Child... 


A EY x | 
Select Template 


Creates a table in the view 


of Cut Ctrl+X 
村 Copy Ctrl+C 
(3 Paste Ctrl+V 
Replace With » 
X Delete Delete 


Template Instance Name Table01 


Move Up 
Move Down 


Parameter Mapping 
Translatable Texts 


Apply Template | 


Binding Chain 


Creates a table in the view 


Expand All 
Show Help 


Properties Alt+Enter 


=P Button 
Context Menus 


图 3-53 应 用 模板 菜单 选择 图 3-54 模板 类 型 选择 


5) 选中 “Per” 结 点 和 属性 J， 单 击 “Next” 按 钮 完成 创建 ， 如 图 3-55 所 示 。 


图 3-55 选择 对 应 上 下 文 
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6) 适当 调整 生成 Table_0 的 宽度 ， 如 图 3-56 所 示 。 


区 Problems | 国 Properties 2 SE Snippets | Infrastructure Console | @) Error Log | Z Tasks | 


E Table 
rouaomy — 
General rowSelectable true 
LayoutData | scrollableColCount A 
| selectedPopin 
exons selectionChangeBehaviour auto* 
selectionMode auto* 
tooltip a 
visible visible* 
visibleRowCount 5 
gi! m 


K| 3-56 设置 表格 属性 
7) 切换 到 wdDolInit( ) 方 法 ， 并 添加 以 下 代码 (ULE 3-57) : 


createAndAddPerElement = wdContext. nodePer( ). createAndAddPerElement( ) ; 
createAndAddPerElement. setld( "13" ) ; 


//@@begin javadoc:wdDoInit () 
/** Hook method called to initialize controller. */ 
//@@end 
public void wdDoInit () 
{ 
//@@begin wdDoInit () 


// waComponentAPI.getMessageManager () .reportSuccess ("Init"); 
// waContext.currentContextElement () .setName ("FAR") ; 
wdComponentAPI.getMessageManager () .reportSuccess ( 

"PerNode Size:" + wdContext.nodePer().size()); 
IPerElement createAndAddPerElement = wdContext.nodePer () 

. createAndAddPerElement (); 
createAndAddPerElement.setId("12"); 


wdComponentAPI. getMessageManager () . reportSuccess ( 
"PerNode Size:" + wdContext.nodePer().size()); 
// waContext.createContextElement (); 


//@@end 


图 3-57 添加 自 定义 代码 
8) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 。 初 始 化 时 ， 打 印 的 
node Size 值 为 2，Table_0 默认 选中 第 一 条 ， 运 行 效果 如 图 3-58 所 示 。 


(By Periode Siret 
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9) 单 击 “Button” 按 钮 后 ， 消 息 打 印 出 一 条 Element 的 引用 ， 如 图 3-59 所 示 。 


Al3-59 fi “Button” 按钮 后 的 运行 效果 
10) 选中 表格 第 二 条 行 项 目 ， 并 单 击 “Button” 按 钮 ， 如 图 3-60 所 示 。 


FO HO) Sew KÆRA IAW Feo 


PerNode Ste 0 
PerNode Ste 1 
< | g 


3-60 ”选择 表格 
11) 单 击 “Button” 按 钮 ， 运 行 效果 如 图 3-61 所 示 。 


ld Value Method1:NodeElement(Dynp01Comp/Dynp02CompView.Per.1) 


图 3-61 单 击 “Button” 按 钮 后 的 运行 效果 


N 


此 时 current < NAME > Element 指向 对 第 二 条 Element 的 引用 ， 即 当 Table_0 的 Selection 
Mode 为 单 选 时 (如果 Selection Mode 属性 为 aato， 则 表格 控件 的 选择 模式 由 绑 定 的 数据 结构 
决定 ， 上 下 文 结 点 “Per” 的 选择 属性 为 “0..1”， 所 以 表格 选择 模式 默认 为 单 选 ) ， 针 对 表 
格 行 项 目的 单 击 动作 会 对 表格 的 首选 项 属性 “Lead Selection” 进行 相应 修改 ， 随 后 current 
<NAME > Element 返回 修改 后 的 首选 项 属性 所 指向 的 行 项 目的 引用 。 

12) 修改 node Per 的 selection cardinality W 0.. n, Initialize lead selection 为 false， 同 时 切 
HFI] Outline 一 Table_0 一 Properties 一 Selection Mode， 并 设置 为 multiNoLead (multiNoLead 为 多 
选 模式 ， 但 选中 行 项 目 时 不 设置 Lead Selection) ， 重 新 编译 、 部 署 ， 运 行程 序 。 从 运行 的 结 
果 可 以 看 出 ， 在 上 下 文 结 点 的 “Initialize Lead Selection” X false， 同 时 以 该 结 点 为 数据 源 的 
表格 选择 模式 设置 为 * No Lead fh}, current < NAME > Element 返回 始终 为 空 ， 即 结 点 并 没有 
被 赋值 为 lead selected 的 元 素 ， 运 行 效 果 如 图 3-62 所 示 。 


ld Value Method1:null 


图 3-62 修改 后 的 运行 效果 
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3.2.4 视图 的 自 定 义 方 法 


3.1.1 节 介 绍 了 视图 中 的 一 些 标准 方法 ， 也 可 以 在 视图 控制 器 ( 即 视 图 类 ) 中 创建 自 定 
义 方法 (Methods) 并 定义 方法 的 参数 、 方 法 的 返回 类 型 等 内 容 。 当 需要 创建 一 个 自 定义 方 
法 时 ， 由 于 Web Dynpro 的 特殊 性 ， 开 发 人 员 并 不 能 直接 在 视图 控制 器 中 编写 代码 ， 而 是 通 
过 NWDS 进行 方法 的 创建 。 

1) 首先 需要 在 视图 的 “Properties” 选 项 卡 中 找到 “Methods”， 在 “Methods” 下 进行 
方法 定义 ， 如 图 3-63 所 示 。 

i£: 在 NetWeaver 7.0 及 其 之 前 版 本 的 开发 工具 中 ， 方 法 的 定义 是 在 与 布局 “Layout” 
并 列 的 “Methods” 中 ， 然 而 在 新 版 本 的 开发 工具 里 上 下 文 、 方 法 、 事 件 处 理 器 等 内 容 统一 
被 包含 在 “Properties” 选 项 卡 中 。 


区 Problems | #] Tasks |) Propertie: xe Infrastructure Console 
日 StartView 


General 


References 


Details | Parameters | Exceptions 


type filter text g Name: 


Return Type: 


= Documentation: | 
Miscellaneous 


Al3-63 定义 自 定义 方法 
2) 单 击 图 3-63 中 的 加 号 按钮 ， 进 行 方 法 的 创建 ， 输 入 方法 名 并 选择 相应 的 返回 类 型 ， 
单 击 “Next” 按 钮 ， 如 图 3-64 所 示 。 


New Method 


Specify Method Properties 


Enter properties of Method 


Name myMethod| 
Return Type 
[LArray Type 


Dimension 


图 3-64 输入 方法 名 称 
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3) 如 果 方 法 存在 参数 ， 则 单 击 “New” 按钮 进行 定义 ， 如 图 3-65 所 示 。 


New Method 


Create Parameters 


Enter parameters details 


图 3-65 定义 方法 的 参数 
4) 在 弹出 的 新 建 参数 窗口 中 输入 参数 名 称 并 选择 对 应 的 参数 类 型 ， 单 击 “ Finish” 按 


钮 ， 如 图 3-66 所 示 。 


New Parameter 


Specify Parameter Properties 


Enter a name and a type for the new parameter 


Name paral 


Type | string 


[_] Array Type 


Dimension 


图 3-66 定义 3 


新 的 参数 


5) 在 完成 参数 创建 后 ， 单 击 “Finish” 按钮 ， 如 图 3-67 所 示 。 
6) 至 此 完成 了 自 定 义 方法 的 创建 ， 在 “Methods” 下 能 看 到 对 应 的 方法 ， 如 图 3-68 


所 示 。 


7) 在 保存 之 后 (如果 未 保存 ， 则 双击 后 无 法 看 到 对 应 的 方法 )， 双 击 自 定义 方法 就 能 


进入 控制 器 进行 代码 编写 ， 如 图 3-69 所 示 。 
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New Method 


Create Parameters 


Enter parameters details 


Name 


| paral 


3-67 ”完成 参数 创建 


区 Problems | Ë) Tasks | Properti xe [E] Infrastructure Console | 
国 StartView 


Details | Parameters | Exceptions 


type filter text & ame 


paral 
Method - voi 
Event Handlers SB myMethod _ wid 


Miscellaneous 


3-68 完成 方法 创建 


public void myMethod( java.lang.String parai ) { 
//@@begin myMethod() 
//@@end 


} 


3-69 ”编辑 方法 的 代码 


3.2.5 视图 的 事件 处 理 器 


Sa (Pb FA (Event handler) 是 Web Dynpro 中 一 种 特殊 的 方法 ,在 NetWeaver 7.0 及 
其 之 前 的 版 本 中 ， 事 件 处 理 器 与 方法 的 创建 是 在 同一 选项 卡 中 ， 通 过 两 个 单 选 项 区 分 ， 
而 在 新 版 本 的 开发 工具 中 ， 事 件 处 理 器 被 单独 放 在 一 个 “Event Handlers” 中 ， 如 图 3-70 
所 示 。 
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HRA 3-70 中 的 加 号 按钮 ， 即 可 进行 事 ”Rs aya 
件 处 理 器 的 创建 。 在 弹出 的 对 话 框 中 输入 名 | References | 


a type filter text x 
称 ， 选 择 需 要 订阅 的 事件 ， 单 击 “Finish” 按 = 一 一 
钮 即 可 ， 如 图 3-71 所 示 。 PAT 


在 Web Dynpro 中 事件 (Event) 来 源 于 以 | Actions 


下 3 种 情况 pugs 
1) 在 组 件 控制 器 中 创建 的 自 定义 事件 (Mees 
(Event) , 


图 3-70 事件 处 理 器 选项 卡 


2) 视图 页 面 的 UL 元 素 的 特定 动作 产生 的 
特定 事件 (onAction Event) 。 
3) 视图 相互 切换 的 导航 插口 对 应 的 导航 事件 (Navigation Event) ) 。 


a 
New Method 


Specify Event Handler Properties 三 
Enter properties of Event hanlder H 
Name myEventHandler 
|| Return Type void Y | | Browse... 
I Array Type 
‘| Dimension 
| Event Source X 
| Subscribed Event | "| 


Create event handler parameters according to subscribed event 


@ Tr || near 


3-71 创建 事件 处 理 器 


需要 特别 注意 的 是 ,一般 情 况 下 第 一 种 自 定 义 事件 的 情况 需要 开发 人 员 手 动 地 创建 对 应 
的 事件 处 理 器 ， 且 自 定 义 事件 只 能 在 组 件 控制 器 中 定义 ， 视 图 、 窗 口中 都 无 法 创建 自 定 义 事 
件 ; 对 于 后 面 两 种 情况 ,创建 视图 的 动作 或 者 插口 后 ， 开 发 工具 都 会 自动 生成 对 应 的 事件 处 
理 需 ， 而 动作 只 能 在 视图 中 定义 。 

1. 视图 的 动作 

在 实施 项 目 中 ， 大 部 分 事件 都 来 自 于 视图 UI 元素 的 动作 ， 特 定 的 UI 元素 会 触发 特定 的 
事件 ， 即 产生 了 用 户 交 互 式 活动 ， 如 按钮 的 单 击 、 表 格 行 的 切换 和 下 拉 菜 单 的 选择 等 。 按 钮 
事件 的 定义 如 图 3-72 所 示 。 

选中 视图 中 的 UI 元 素 ， 找 到 对 应 的 “Events” 子 标签 ， 就 能 通过 单 击 “Create” 创建 动 
Ve, SUPA 3-73 所 示 。 注 : 在 NetWeaver 7.0 及 其 之 前 版 本 中 ，Event 是 在 属性 中 进行 定义 ， 
新 版 本 已 经 分 配 了 单独 的 标签 进行 配置 。 
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General Property 
4 Events 


| onAction +|Go |[Create | i 
Events 


3-72 ”按钮 事件 的 定义 


一 一 一 
Ld 


New Action 一 -一 le Sm 


Specify Action Properties 


Enter the properties for the new action 


Name Click 


| Text 
Icon Browse... 
Validation 区 


Event Handler 


© Use Default 


onActionClick 


© Use existing 


| J] Adapt parameters to fit event handler parameters 


Fire Plug | <None> 


3-73 创建 自 定 义 动作 
创建 动作 时 需要 填写 的 内 容 见 表 3-3。 


表 3-3 创建 动作 时 需要 填写 的 内 容 


标 签 填写 说明 
Name 动作 的 名 称 
Text 动作 的 描述 文本 
Teon 动作 的 图 标 ( 图标 会 对 应 出 现在 视图 中 ) 
Validation 是 否 校 验 
Event Handler (Use Default/Use existing) 选择 ( 默认 创建 /已 存在 的 ) 事件 处 理 器 
Fire Plug 选择 需要 触发 的 视图 插 


如 果 选 择 默 认 创建 事件 处 理 器 ,保存 之 后 会 对 应 生成 一 个 onAction < NAME > 的 事件 处 
理 需 方法 ， 这 个 方法 就 是 用 于 处 理 客户 端 用 户 交 互 活动 的 事件 。 最 终 完成 了 从 客户 端的 用 户 
操作 到 视图 页 面 元 素 ， 随 后 触发 特定 的 事件 ， 再 通过 事件 处 理 需 进行 服务 端 逻辑 处 理 的 过 
fe: FAR (User) -操作 (Action) - 页面 元 素 (UI Element) -事件 (Event) - 事件 处 理 器 
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(Event Handler) , 
2. 视图 的 插口 


视图 的 插口 是 同一 窗口 中 不 同 视图 进行 切换 的 出 入 口 ， 在 视图 的 


中 可 以 找到 对 应 的 “Plugs” 子 标签 ， 如 图 3-74 所 示 。 


区 Problems | 4] Tasks (Propertie 
H StartView 


type filter text 


BS Infrastructure Console | 


Details | Parameters 


Name: 


Miscellaneous 


图 3-74 


ÉA Outbound Plug (红色 ) 和 Inbound 
Plug CHE) 两 种 类 型 ， 分 别 作为 出 口 和 入 口 ， 


如 图 3-75 tas 


当 Outbound 被 触发 (fire) 时 ,会 产生 一 
个 导航 事件 (Navigation Event) ， 根 据 在 窗口 中 
定义 的 导航 链接 ， 触 发 对 应 Inbound 的 事件 处 理 器 ， 同 时 视 


开发 实例 : 


1) 在 “Dynpro01Comp” 组 件 中 ， 右 击 “Views” 视 图 ， 创建“Dynp01_PL01_View” 和 
“Dynp01_PLO2_View” 两 个 视图 ， 如 图 3- 
2) 右 击 “Windows”， 创 建 一 个 窗口 Dynp01CompPlugWin， 如 果 使 用 已 存在 的 窗口 ,i 
直接 从 第 9) 步 开始 进行 ， 如 图 3-77 所 示 。 


Type: 


standard 


Documentation: | 


“Plugs” 子 标签 


Inbound Plug 
Outbound Plug 


图 3-75 两 种 不 同类 型 
图 页 面 进行 切换 。 


76 所 示 。 


“Properties” 选项 卡 


w EP Search | ts. Navigat | 7 日 || 


图 | sl te 
4 și Dynp01Comp 

è Component Controller 

> Local Component Interface 

$% Custom Controllers 

@ Implemented Interfaces 

国 Message Pool 

@ Used Models 

«éj Used Components 


a 


国 


R9 Search |% Navigat | 


sit 
4 <j Dynp01Comp 
@ Component Controller 
> Local Component Interface 
$e Custom Controllers 
@ Implemented Interfaces 
国 Message Pool 


@y Used Models 
«i Used Components 


> FB Vi 
b Wi Create View 
> @ Dictionaries Paste 
ÈR 
= _ min Compare Metadata 
b @& src | 
EE META-IN Development Component 
> @ WEB-INF | & Remove from Context 
图 3-76 创建 视 医 
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S ~ Create Window 
> @ Dictionaries 


4 © Resources 
> @ sre 
@ META-INF 
> @ WEB-INF 


Compare Metadata 


3-77 创建 新 的 窗口 


Development Component 


Remove from Context 


3) 创建 窗口 对 应 的 接口 视图 ， 如 图 3-78 所 示 。 
4) 输入 接口 视图 的 名 称 ， 单 击 “Finish” 按 钮 ， 如 图 3-79 所 示 。 


名 Search Console) %5- Navigator 


a yi Web Dynpro 
Ra Applications 
> Models 
图 Component Interfaces 


New Interface View 


Specify Interface View Properties 
4 « Components 
4 «fj Dynp01Comp 
gÈ Component Controller 
4 Local Component Interface 
® Inherited Interfaces 


Enter a name and a package for the new interface view 


Name Dynp01Comp_PLug_IntV| 


Package com.sap.demo.mydynp01.wd.comp.dynp01lcomp 


Compare Metadata 


Development Component 


| Finish | | Cancel 


Remove from Context 


N 


3-78 创建 接口 视图 图 3-79 输入 接口 视图 名 称 


5) 由 于 接口 视图 对 外 公开 ， 因 此 必须 存在 默认 的 Inbound 插口 。 打 开 接 口 视图 ， 单 击 
左 侧 的 “New” 按 钮 ， 如 图 3-80 所 示 。 


Plugs 
v Inbound Plugs ~ Outbound Plugs 
Displays the inbound plugs Displays the outbound plugs 


Name Type Name Type 


~ Parameters 


Displays the parameters of the selected Plug 


Name Type 


N 


3-80 ”创建 新 插口 


6) 创建 类 型 为 “Startup” 的 插口 ， 输 入 插口 名 称 ， 如 图 3-81 ras, it “Finish” fX 
钮 并 保存 。 

7) 将 接口 视图 与 之 前 创建 的 窗口 进行 关联 (如 默认 创建 的 窗口 ， 将 自动 完成 这 些 配 
置 ) ， 接 着 打开 Dynp01CompPlugWin 窗口 ， 在 “Properties” 选 项 卡 中 找到 “JInterfaceViews” 
子 标签 ， 单 击 创建 视图 按钮 ， 如 图 3-82 所 示 。 

8) 在 弹出 的 对 话 框 中 选择 刚才 创建 的 接口 视图 “Dynp01Comp_Plug_IntV”( 见 图 3-83), 
单 击 “OK” 按 钮 并 保存 。 

9) 所 有 的 配置 完成 后 ， 单 击 “ 保 存 ” 按 钮 保存 所 有 修改 内 容 ， 如 图 3-84 所 示 。 

10) 打开 窗口 ， 在 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 选择 “Embed View”， 如 图 3-85 所 示 。 
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KB New inbound Plug aN =o x | 区 Problems (B X B Snippets] Infrastructure Consd 
| Specity Inbound Plug Properties E Dynp0lCompPlugWin 


Enter the properties of the inbound plug and the event handler 
General Interface View [el 


Name St 


Type 


Miscellaneous 


图 3-81 输入 插口 名 称 


BS 


3-82 ”实现 接口 视图 


Add Interface View to Implement Ehehe 


Select one or more interface views: 


3| 


| Dynp01Comp02IntV - com.sap.demo.mydynp0: 
Dynp01Comp03iIntV - com.sap.demo.mydynp0| 
V) Dynp01Comp_PLug_IntV - com.sap.demo.myd: 
E| Dynp01CompIntertaceView - com.sap.demo.my 


4 ( Views 
F Dynp01_PLO1_View 
Fj Dynp01_PLO2_View 

4 (© Windows 
(Z Dynp01CompPlugWin | 


图 3-83 ”选择 对 应 接口 视图 图 3-84 配置 完成 后 的 目录 


11) 在 弹出 的 对 话 框 中 选中 “Embed Existing View” 单 选 按钮 ， 骨 入 已 存在 的 视图 ， 单 
击 “Next” 按 钮 ， 如 图 3-86 所 示 。 


Undo z 
Embed View 
Redo 
Specify whether you want to create a new view or reuse an existing view, 
Open if you want to embed the empty view or an interface view of used components. 
Open with 上 
properties © Embed new view 
@ Embed Existing View 
X Delete © Embed Empty View 
E] Embed View © Embed Interface View of a Component Instance 
国 Create View Set 
@ Create Inbound Plug 
æ Create Outbound Plug 
Layout -| 
Ze Finish 


图 3-85 选择 能 入 视图 图 3-86 选择 能 入 类 型 


50 


12) 选择 对 应 的 视图 Dynp01_PLO1_View, 


Embed View 


单 击 “Finish” 按钮 ， 如 图 3-87 所 示 。 


Select View 


Select one of the existing views that you want to embed 


Embed View 


Select the view that you want to embed 


View 


| Dynp01_PLO1_View — 
Dynp01_PLO2_View 


Locations 


Locations of the embedded view 


Locations 


3-87 


FERAM 


13) 重复 步骤 4) ~ 46), BATA “Dynp0l_PLO2_View” WASA OP, 4n 


Al 3-88 所 示 。 


14) 将 鼠标 移 至 “Dynp01_PL01_View” 上 ， 通 过 弹出 的 快捷 菜单 分 别 创建 “Inbound” 


插口 与 “OutBound” 插 口 ， 如 图 3-89 所 示 。 


4 


paket Mees |] Dynp01CompPlugWin 


日 
Dynp01_PLO1_ 
View 


a 
Dynp01_PL 
02_View 


图 3-88 完成 能 入 后 的 效果 


NS 


Dynp01_PLO1_ 
View 


3-89 通过 快捷 菜单 创建 插口 


15) 单 击 对 应 的 按钮 ， 即 可 自动 创建 对 应 的 插口 。 图 3-90 所 示 为 创建 的 “Inbound” 


插口 。 


5I 


16) 图 3-91 所 示 为 创建 “Outbound” 插 口 。 


FE] Dynp01CompPlugWin $8 


í [LocalDevelopment] mydynp01 > 4§ Dynp01Comp 


3 


| 

| Gi 
| 

a [ea] | 
| Dynp01_PLO1_ 

| View 

| 

| 

| 

| 

| 

| 


InboundPlug 
Creates an inbound plug in a view 


oa 


BS 


3-90 B “Inbound” fii O FR KI 3-91 


AJ “Outbound” {i O FREH 


17) 同样 地 ， 为 Dynp01_PLO2_View 视图 创建 两 个 插口 后 ， 单 击 右 侧 的 “Link” 按 钮 ， 
创建 导航 链接 ， 如 图 3-92 所 示 。 


注 : 只 能 将 Outbound Plug 4 Inbound Plug 相连 ， 同 类 型 的 插口 无 法 创建 导航 链接 。 
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[LocalDevelopment] mydynp01 门 Dynp0lCompPlugWin Se ee 


È Views 


Ne ve 
d A | 国 Existing View 


Dynp01_PLO1 gp || B Interface View 
View 


|| & Viewsets 


El TLayout270 
[E TLayout90 

|| Navigation 
my 
E Outbound Plug 


# Link 


Navigation 


Al 3-92 创建 导航 链接 
18) 在 弹出 的 窗口 中 选 勾 选 第 二 项 由 向 导 创 建 默认 按钮 以 执行 跳 转 动作 ， 如 图 3-93 
所 示 。 如 果 已 手动 创建 按钮 ， 则 不 需要 勾 选 可 跳 过 。 
19) 用 同样 的 方法 创建 一 个 返回 的 导航 链接 ， 即 完成 关联 ， 如 图 3-94 所 示 。 


Navigation Details 


Create Navigation Link 
Navigation Link will be created between the source view and target view. 
Specify the name of Link and option for firing navigation. 

Fire Navigation 


E] Use existing method in View Dynp01_PLO2_View to fire navigation 


Method: 


Ly 


3-93 ”自动 创建 按钮 选项 图 3-94 创建 返回 导航 
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20) 右 击 “Applications” 创 建 一 个 应 用 ， 如 图 3-95 所 示 。 


4 [SE [LocalDevelopment] mydynp01 
4 yi Web aa 


Paste 


Compare Metadata 


Development Component 


Remove from Context 


3-95 创建 应 用 程序 


21) 自 定义 应 用 名 称 和 包 名 ， 单 击 “Next” 按 钮 ， 如 图 3-96 所 示 。 
22) 选择 应 用 运行 时 需要 展示 的 接口 视图 ， 如 图 3-97 所 示 。 


二 二 人 
New Applicaton Tree ES Nex ip 000 
Application Properties Select References 
Enter the properties for the new application leferences for the 


Name | Dynp01Comp_Plug App 


Package com.sap.demo.mydynp01.wd.app.dynp01comp_plug_app 
加 Authentication 


图 3-96 输入 应 用 名 称 


器 


3-97 ”选择 对 应 的 接口 视 
23) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 “Dynp01Comp_Plug_App” 应 
用 测试 ， 运 行 效果 如 图 3-98 所 示 。 


24) 单 击 “ToDynp01_PL01_View” 按 钮 即 可 跳 转 到 PLO1_View， 再 次 单 击 该 按钮 ， 则 
跳 回 ， 如 图 3-99 所 示 。 


六 


3-98 ”运行 效果 图 3-99 ” 单 击 按钮 运行 效果 
注 : 自动 生成 代码 是 NWDS 一 个 强大 的 功能 。 在 本 实例 中 ， 按 钮 的 定义 、 导 航 事 件 的 
处 理 和 触发 都 是 在 创建 导航 链接 时 。 
3.2.6 视图 的 UI 元 素 


1. UI TNA 
Web Dynpro 将 Java 中 的 图 形 化 开发 进行 了 彻底 的 封装 ,在 NWDS 的 视图 开发 中 可 以 直 
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接 在 视图 编辑 器 中 通过 图 形 化 的 开发 方式 进行 界面 元 素 的 修改 和 调整 ， 大 大 减 小 了 代码 编写 
的 工作 量 ， 同 时 也 降低 了 开发 人 员 的 学 习 难 度 。 接 触 过 网 页 开发 或 其 他 页 面 搭建 的 用 户 ， 应 
该 经 常会 接触 到 “控件 ”或 者 “UI 控件 ”这 样 的 描述 ， 而 在 Web Dynpro 中 确切 的 叫 法 是 
“用 户 界 面 元 素 ” 或 “UI 元 素 ”(User Interface Element) o 

Web Dynpro 中 的 UI 元 素 有 许多 不 同 的 类 型 ， 包 括 简单 元 素 ( 如 文本 框 、 标 签 、 按 钮 等 
TUR). 、 复 杂 元 素 (如 表格 、 列 表 、 工 具 栏 等 ) 以 及 特殊 元 素 〈 如 交互 表单 、 定 时 器 、 图 片 
等 ) ， 方 便 开 发 人 员 满 足 不 同 的 业务 需求 ， 如 图 3-100 所 示 。 


[局 New UI Element OO a E o 


Create a new UI element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] [All] |E Table 
Action Active Components F TabStrip 
Complex Adobe $| TextEdit 
Graphic Analytics TextView 
Integration Business Graphics &@ TimedTrigger 


Layout Business Intelligence E ToggleButton 

Menu Calendar ras ToggleLink 

Selection Mobile Add-Ons = ToolBar 

Text Office Integration =P ToolBarButton 

Toolbar Pattern Development E ToolBarButtonChoice 

Realtime Messaging TF ToolBarDropDownBylndex 

Standard T ToolBarDropDownByKey E 
= ToolBarInputField f 

S5 ToolBarLinkChoice 


= ToolBarLinkToAction 


ID Tablel 


Documentation 


Table represents a two-dimensional data set arranged in rows and columns. 


Data binding: 
Atable gets its data from a context node Rows. 


e The number of table rows is given by the size of node Rows 


BS 


3-100 Ul 元 素 的 各 种 类 型 


2. 动态 创建 视图 页 面 元 素 

通常 情况 下 ， 在 设计 视图 的 布局 (Layout) 和 UI 元 素 (UI Element) 时 ， 都 是 在 数据 定 
义 或 数据 结构 已 知 的 情况 下 完成 页 面 元 素 的 创建 、 属 性 的 设 定 以 及 页 面 元 素 的 整体 布局 ， 在 
数据 结构 本 身 并 不 确定 的 前 提 下 ， 就 需要 能 够 在 程序 运行 时 根据 实时 运行 结果 得 到 的 数据 结 
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构 动 态 地 进行 页 面 控件 的 生成 了 。 

当然 对 于 部 分 静态 页 面 的 需求 或 者 一 些 通用 布局 的 页 面 ， 也 可 通过 页 面 元 素 的 APL 进行 
创建 ， 但 一 定 要 注意 程序 的 运行 效率 ， 切 勿 为 了 写 代码 而 写 代 码 ， 从 而 变 得 舍 本 逐 末 。 

$KE, Web Dynpro 不 仅 支 持 动态 的 页 面 元 素 创 建 ， 还 支持 动态 上 下 文 (Context) 的 
创建 和 动作 (Action) 的 动态 分 配 ， 这 里 仅 以 动态 的 页 面 元 素 创建 为 例 进行 讲解 ， 后 两 者 在 
实际 项 目 中 遇 到 的 情况 并 不 多 。 

在 Web Dynpro 中 ,视图 控制 如 通过 “wdModifyView” 方 法 提供 给 开发 人 员 动 态 创 
建 视图 页 面 元 素 的 唯一 入 口 。 该 方法 有 两 个 参数 ， 分 别 是 类 型 为 “IWDView” 的 视图 
实例 与 类 型 为 布尔 型 的 “firstTime”。 其 中 ， 视 图 实例 可 以 用 于 获取 、 创 建 当 前 页 面 的 
实例 以 及 其 中 所 有 UI 元 素 ,， 并 可 通过 标准 API 对 元 素 属性 进行 动态 地 设置 和 调整 ; 
“firstTime” 参数 用 于 标识 方法 是 否 为 第 一 次 执行 ， 通 过 “firstTime” 可 以 控制 方法 逻辑 
的 执行 频率 。 如 “firstTime == true” 时 ， 表 示 现 在 是 程序 页 面 第 一 次 初始 化 ， 可 写 入 初 
始 化 的 动态 页 面 元 素 创建 的 代码 。 下 面 通过 一 个 开发 实例 来 看 一 下 动态 创建 在 项 目 实 
施 中 的 实际 应 用 。 

开发 实例 : 

HR: 单 击 页 面 上 的 按钮 ， 动 态 创建 两 个 标签 和 两 个 文本 框 。 

1) Æ Web Dynpro 项 目的 视图 中 添加 一 个 按钮 ， 如 图 3-101 所 示 。 

2) 上 下 文中 新 建 一 个 布尔 型 特性 “isCreateForm”， 如 图 3-102 所 示 。 


SY Context 


IsCreateFor 
图 3-101 添加 按钮 元 素 图 3-102 创建 上 下 文 特性 


3) 编写 触发 按钮 的 动作 ， 当 单 击 “触发 ”按钮 时 ， 动 作对 应 的 逻辑 代码 就 会 修改 变 
量 ， 并 在 运行 时 新 建 上 下 文 特性 。 


//@ @ begin onActionCreateForm( ServerEvent ) 

// 设 置 变量 

wdContext. currentContextElement( ). setIsCreateForm( true) ; 

// 创 建 Context Node 

IWDNodelInfo perInfo = wdContext. wdGetAPI( ). getRootNodeInfo( ). addChild( 
"Perlnfo" , null, true, CMICardinality. ONE, 
CMICardinality. ZERO_TO_ONE, true, null); 

//Node 下 新 增 两 个 属性 :Id 与 Name 

// 新 建 属性 

IWDAttributelInfo id = perInfo. addAttribute("Id" , 
"ddic :com. sap. dictionary. string" ) ; 

IWDNodeElement currentElement = wdContext. getChildNode(" PerInfo" , 0) 
. getCurrentElement( ) ; 

// 设 置 属性 值 

currentElement. setAttributeValue( "Id" , " P001" ) ; 

// 新 建 属性 

IWDAttributeInfo name =perInfo. addAttribute( " Name" , 
"ddic:com. sap. dictionary. string" ) ; 
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/设置 属性 值 
currentElement. setAttributeValue( "Name" , " Blus" ) ; 


//@ @ end 


4) 在 “wdModifyView” 方 法 中 通过 控制 变量 ， 生 成 Ul 元 素 ， 方 法 在 动作 执行 完毕 后 执行 。 


//@ @ begin wdDoModify View 
// 获 取 控 制 变量 
boolean isCreateForm = wdContext. currentContextElement( ) 
. getIsCreateForm( ) ; 
if(isCreateForm) | 
// SL view 根 结 点 
IWDTransparentContainer container = ( IWDTransparentContainer ) view 
. getElement ( " RootElement" ) ; 
// FB ES E BE TransparentContainer 
IWDTransparentContainer [WDTransparentContaine101 = null; 
if( view. getElement ("TWDTransparentContainer01" ) == null) | 
// 创 建 TransparentContainer 
IWDTransparentContainer01 = view. createElement( 


IWDTransparentContainer. class, 
"IWDTransparentContainer01" ) ; 
// 是 否 属 于 LayoutContainer 
IWDTransparentContainer01. setlsLayoutContainer( true ) ; 
// 设 置 GridLayout 
IWDGridLayout gridLayout = IWDTransparentContainer01 
. createLayout( IWDGridLayout. class) ; 
//GridLayout 布局 
gridLayout. setColCount(2); 
// 设 置 TransparentContainer 可 见 性 
IWDTransparentContainer01. setVisible( WDVisibility. VISIBLE) ; 
// 新 建 的 Container 添加 至 根 结 点 
container. addChild ( IWDTransparentContainer01 ) ; 


} 
// 获 取 运 行 时 创建 的 Node, 该 处 可 以 设置 为 动态 变量 
IWDNode childNode = wdContext getChildNode( " PerInfo" , 0) ; 
// 获 取 新 建 的 currentNodeElement 
IWDNodeElement currentElement = childNode. getCurrentElement( ); 
// 通 过 Nodelnfo 获取 所 有 属性 
List <? extends IWDAttributelInfo > attributes = childNode 
. getNodeInfo( ). getAttributes( ) ; 
/遍历 所 有 属性 并 动态 创建 UI 元素 ,该 处 每 一 个 属性 生成 对 应 的 Label 与 mputField 
for(IWDAttributeInfo attrinfo ; attributes) | 
/人 /获取 属性 名 称 
String attr = attrinfo. getName( ) ; 
// 根 据 属性 名 称 获取 属性 值 
String attrValue = ( String) currentElement 
. getAttributeValue (attr) ; 
// FIERE AX DN EN 
if( view. getElement(" Label" + attr) == null) į 
// 创 建 Node 属性 对 应 的 label 元 素 
IWDLabel labelld = ( IWDLabel ) view. createElement( 
IWDLabel. class, " Label" + attr); 
// 设 置 元 素 可 见 性 
labelld. setVisible( WDVisibility. VISIBLE) ; 
// 设 置 labeltext 


labelld. setText( attr) ; 
// 添 加 label 元 素 至 TransparentContainer 
IWDTransparentContaine101. addChild( labelld ) ; 
| 
// 判 断 是 否 已 有 对 应 的 控件 
if( view. getElement(" InputField" + attr) ==null)| 
// 创 建 Node 属性 对 应 的 InputField 元 素 
IWDInputField inputfield = (IWDInputField ) view 
. createElement( IWDInputField. class, " InputField" 
+attr) ; 
// 控 件 绑 定 属性 值 ,该 值 为 path 
inputfield. bindValue( " PerInfo. " + attr) ; 
/人 /设置 元 素 可 见 性 
inputfield. setVisible( WDVisibility. VISIBLE) ; 
// 添 加 InputField 元 素 至 TransparentContainer 
IWDTransparentContainer01. addChild( inputfield) ; 


| 


} 
//@ @ end 


5) 保存 所 有 修改 ， 重 新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效 果 如 图 3-103 所 示 。 
6) 单 击 “ 创 建 表单 ”按钮 ， 页 面 动态 创建 的 Ul 元 素 如 图 3-104 所 示 。 


P001 


Ead Name: Blus 


hs 


建 表单 ”按钮 的 运行 效果 


图 3-103 运行 效果 图 3-104 单 击 “多 

上 面 的 例子 是 一 个 简单 的 根据 上 下 文 动态 生成 界面 元 素 的 过 程 ， 在 运行 时 新 增 了 两 个 上 
下 文 特 性 ， 然 后 根据 这 些 特性 的 名 称 、 类 型 等 动态 地 创建 了 视图 中 的 UI 元素 ， 即 每 个 属性 
对 应 一 组 文本 标签 和 输入 框 元 素 。 

实际 上 ， 页 面 的 所 有 元 素 都 有 其 TIWDView 的 UI Element API， 通 过 这 些 API 可 以 创建 新 
的 元 素 ， 也 可 以 编辑 这 些 元 素 的 属性 ， 所 有 的 元 素 再 通过 上 下 级 的 关联 来 构造 出 整个 树 形 结 
构 的 页 面 布局 。 

动态 的 页 面 元 素 解决 了 数据 结构 不 确定 的 情况 下 页 面 构造 的 问题 ， 从 整个 代码 API 构造 
的 过 程 可 以 看 出 ，WEBDYNPRO 提供 的 模板 布局 的 快速 。 由 于 wdDoModifyView 方法 的 执行 
频率 很 高 ， 因 此 不 建议 在 该 方法 中 编写 更 多 的 逻辑 OE: 尤其 不 允许 编写 数据 相关 逻辑 ， 
因为 这 与 MVC 架构 不 符 ， 且 会 影响 后 期 代码 维护 ) 。 需 要 特别 注意 ，wdDoModifyView 频繁 
执行 时 客户 端的 性 能 及 服务 端的 响应 时 间 。 


3.3 窗口 


ka 


节 将 具体 介绍 Web Dynpro 中 的 窗口 。 
3.3.1 窗口 的 属性 


窗口 是 视图 的 载体 ， 每 个 窗口 都 可 以 舰 入 一 个 或 多 个 视图 或 者 视图 集 ， 而 视图 集中 又 可 
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以 艇 入 一 个 或 多 个 视图 或 者 视图 集 ， 就 像 是 一 个 不 断 生 长 的 树 状 结构 (在 老 版 本 的 开发 工 
具 ， 可 以 在 工程 的 目录 中 将 窗口 展开 看 到 类 似 的 结构 但 在 新 版 本 中 无 法 看 到 这 一 结构 ) 。 但 
要 注意 的 是 ， 在 每 一 块 显示 区 域 中 只 能 有 一 个 视图 设置 为 “默认 可 见 ”， 不 允许 有 两 个 或 两 
个 以 上 视图 均 为 “默认 可 见 ” 的 状态 。 

当 在 Web Dynpro 中 创建 一 个 窗口 时 ， 并 不 仅仅 创建 了 一 个 窗口 对 象 ， 同 时 也 创建 了 以 
FAR: 

1) MAW 


在 组 件 中 的 可 视 化 接口 。 

2) 多 个 视图 在 同一 页 面 中 的 布局 和 位 置 。 

3) 多 个 视图 是 否 可 见 ， 以 及 相互 之 间 如 何 切换 。 

需要 注意 的 是 ， 窗 口 实现 了 对 应 的 接口 视图 ， 即 与 接口 视图 (Interface View) 对 应 的 是 
窗口 ， 而 不 是 视图 。 

进入 NWDS 开发 者 工作 室 ， 以 3.1.5 中 创建 的 Dynp01CompPlugWin 窗口 为 例 ， 在 
“ Properties” 中 包含 了 和 若干 子 标签 ， 如 图 3-105 所 示 。 


RR A 


区 Problems | Ñ] Tasks | Properties x _ |B| Infrastructure Console 
iz Dynp0lCompPlugWin 


General Interface View [m] We Window's View Containers 


References 


E Dynp01CompInterfaceView - <Local Component Interface> 
Context 


Methods 
Event Handlers 
Plugs 


| Interface Views 


Miscellaneous 


图 3-105 窗口 的 属 


Hl 
HF 


属性 子 标签 及 功能 说 明 见 表 3-4。 
表 3-4 属性 子 标 签 及 功能 说 明 
属性 子 标签 功能 说 明 
General 基本 信息 
References 引用 ， 艇 入 其 他 组 件 视 图 时 的 控制 器 列表 
Context 上 下 文 ， 同 视图 
Methods 方法 ， 同 视图 
Event Handlers 事件 处 理 咒 ， 同 视图 
Plugs 插口 ， 同 视图 
Interface Views 接口 视图 ， 指 定 当前 窗口 实现 的 具体 接口 视图 
Miscellaneous 其 他 内 容 
这 些 窗口 中 的 属性 子 标签 与 视图 的 属性 用 法 类 似 ， 如 上 下 文 、 方 法 、 事 件 处 理 锅 和 插口 
等 ， 这 里 不 再 蒙 述 。 


3.3.2 窗口 与 接口 视图 


在 Web Dynpro 的 项 目 架构 中 ， 应 用 程序 (Application) 作为 整个 应 用 的 入 口 点 ,窗口 
(Window) 为 应 用 的 界面 ， 接 口 视 图 (InterfaceView) 则 是 Web ae 程序 视图 Ay A 口 点 ， 
任何 新 建 的 接口 视图 都 需要 一 个 默认 的 窗口 实例 去 实现 ， 而 接口 视图 也 衔接 了 入 口 点 与 界面 
的 关联 。 

开发 实例 : 

1) 展开 上 一 节 中 创建 的 Web Dynpro WH, Aif “Interface Views”， 在 弹出 的 快捷 菜单 
中 选择 “Create Interface View” 创 建 一 个 接口 视图 。 在 弹出 的 对 话 框 中 输入 接口 视图 的 名 
称 ， 单 击 “Finish” 按 钮 完成 创建 ， 如 图 3-106 所 示 。 

2) 在 创建 完成 后 ， 双 击 打 开 对 应 的 接口 视图 ， 单 击 “New” 按 钮 ,创建 一 个 “了 In- 
bound” 的 插口 ， 如 图 3-107 所 示 。 


SRO A tantra 
Plugs 
5 ~ Inbound Plugs v Outbound Plugs 
New Interface View ee s lai Displays the inbound plugs i Displays the outbound plugs 


|| Specify Interface View Properties | Name Type Name Type 
Enter a name and a package for the new interface view : _ 


Name Dynp02InterV 


Package com.sap.demo.mydynp01.wd.comp.dynp01comp 


~ Parameters 


Displays the parameters of the selected Plug 


Name Type 


ew.. | 
Up | 
® | Einish | | Cancel | | 


图 3-106 输入 接口 视图 名 称 


N 


3-107 创建 插口 


Ps 在 弹出 的 对 话 框 中 选中 “Startup” 单 选 按钮 启动 类 型 的 查看 ， 并 输入 自 定 义 名 称 
， 单 击 “Finish” 按钮 完成 插口 的 创建 ， 如 图 3-108 所 示 。 


中 z 
New Inbound Plug S) 
Specify Inbound Plug Properties qj 
一 
Enter the properties of the inbound plug and the event handler a” 
Name St 
Type 
I © Standard 
© Resume 
Q < Back Next > Finish Cancel 
B N 


图 3-108 ”选择 插口 类 型 

4) 保存 所 有 修改 后 ， 会 在 编译 时 报错 ( 见 图 3-109)。 在 日 志 中 查看 具体 的 错误 信息 
由 于 刚 创建 的 接口 视图 还 未 被 窗口 实现 ， 因 此 编译 无 法 通过 。 

5) 下 面 创建 一 个 窗口 ， 并 实现 新 建 的 接口 视图 。 首 先 右 击 “Windows”， 在 弹出 的 快捷 
菜单 中 选择 “Create Window” 创 建 一 个 窗口 ， 在 弹出 的 对 话 框 中 输入 自 定义 窗口 名 称 ， 如 
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Al 3-110 所 示 。 


E Properties | [4 Snippets | [E] Infrastructure Console| @] Error Log | Ë) Tasks| 
1 error, 77 warnings, 1 other 


Description 
4 @ Errors (1 item) 


@ Component 'Dynp01Comp': Implementation error: No window implements interface view ‘Dynp02InterV' 
> & Warnings (77 items) 


> i Infos (1 item) 


图 3-109 报错 消息 


6) 单 击 “Add” 按 钮 添加 对 应 实现 的 接口 视图 ， 在 弹出 的 窗口 中 选择 刚才 新 建 的 接口 
视图 “Dynp02InterV”， 单 击 “OK” 按 钮 ， 如 图 3-111 所 示 。 


IS New Window oes 


=) x === 
= en 

| Add Interface View to Implement EIE 
Specify Window Properties 
Enter a name for the new window and a list of interface views to implement Select one or more interface views: 

Dynp01ComplinterfaceView - com.sap.demo.my 
Window Name | Dynp02CompWin Dynp02InterV - com.sap.demo.mydynp01.wd.¢¢ 
Window Package com.sap.demo.mydynp01.wd.comp.dynp01comp | 
Interface Views Per 
Remove 


@ Camis | ene 


(ee ees 


图 3-110 输入 窗口 名 称 


BS 


3-111 选择 对 应 视图 
7) 添加 接口 视图 后 ( 见 图 3-112)， 单 击 “Finish” 按 钮 完成 接口 视图 与 窗口 的 手动 创建 。 


8) 在 手动 创建 完 接口 视图 后 ， 再 实际 应 用 一 下 ， 看 一 下 其 他 组 件 怎 么 引用 接口 视图 。 


首先 在 项 日 中 新 建 一 个 组 件 “Dynp02Comp”， 在 创建 时 选中 “Default Window and Views” 复 
选 框 ， 单 击 “Finish” 按 钮 ， 如 图 3-113 所 示 。 


4 Local Component Interface 


i Now Componene cane 
时 Inherited Interfaces 一 -一 
2È Interface Controller ‖ Specify Component Properties 动 ) 

4 Ea Interface Views Enter name and package for the new Web Dynpro Component 

回 Dynp01CompinterfaceVi | 


E Dynp02InterV 
ge Custom Controllers Component Package com.sap.demo.mydynp01.wd.comp.dynp02con | Browse: 
@ Implemented Interfaces 
图 Message Pool 


Component Name Dynp02Comp 


e Used Models Choose additional capabilities for the new component 
4 FE Views F] Used Models 
fel Dynp01CompView |Implemented Interfaces 


T] Dynp02CompView 
4 Windows 


 Dynp01CompWindow @® 
加 Dynp02CompWin 


< Back Next > Finish Cancel 


Ly 


3-112 创建 后 的 项 目 结构 


3-113 创建 新 的 组 件 
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9) 创建 完成 新 组 件 后 ， 就 能 在 Web Dynpro 项 目 目录 中 看 到 具体 内 容 ， 如 图 3-114 
所 示 。 


F Web Dynpro - [LocalDevelopment] mydynp01/Dynp02Comp - Web Dynpro Component Controller Editor - SAP NetWeaver Developer Studio W E = 
File Edit Navigate Search Project Editor Web Dynpro Run Window Help 


N-e G2 PH Mi 4B is Bi PU- i %-O-Q~ i BOW~ Hr Pr eoro-r sE 
P Web Dyn 52 \ BP Search C | &: Navigator] = D(f Dynp02CompWin È Dynp02Comp £3.» =o 
Easlglheo’ SEED .5 Dynp02Comp 
PL Web Dynpro = 


Œ Applications s 


np02Com.. & E3 
Ef Dyn01App Dynp02Co Component Y_r) Dynp02co 
mpView Controller mpinterf... 
& Models ry A 
[Bl Component Interfaces 


« Components 
ef Dynp01Comp 
E Component Controller 
Local Component Interface 
$< Custom Controllers 


aĝ Custom 
Controller 


| @a Model Usage 


‘Gq Component 


m 


Usage 
} Implemented Interf 

@ Implemented Interfaces EES 
国 Message Pool | 
@, Used Models © Data Sources © 
<Â Used Components || rec 
E Views || web service 
Windows Mee 

cj Dynp02Comp > 
€@ Component Controller | BJava Bean 
Local Component Interface | & More.. 


$< Custom Controllers 


@ Implemented Interfaces 
EE] Message Pool 


l- it leed Modele 二 [区 Problems [E Properties 235E Snippets) [B] Infrastructure Console] @) Error Log| É Tasks] #720 
BE Outline 23N _@ Documentation View im äi pozc 
‘cd ‘om 
| eee : 
agea General v Overview a 
Name com.sap.demo.mydynp01.wd.comp.dynp02comp.Dynp02Comp 


o° Writable 


3-114 ”创建 后 的 项 目 结构 


10) 双击 打开 手动 创建 的 “Dynp02CompWin” 窗 ee 

口 ， 在 右 侧 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 选择 Redo 

“Embed View” 选 项 ， 在 窗口 中 航 入 视图 ， 如 图 3-115 Open 

所 示 。 Open with » 
11) 在 弹出 的 对 话 框 中 选择 嵌入 一 个 接口 视图 ， 如 ih tlie 

图 3-116 所 示 。 
12) 由 于 当前 组 件 还 未 添加 引用 组 件 ， 因 此 先 单 击 

“Add” 按 钮 ， 如 图 3-117 所 示 。 


Delete 


x 

国 Embed View 

m Create View Set 

@ Create Inbound Plug 
=> 


13) 在 弹出 的 对 话 框 中 浏览 并 选中 后 来 新 建 的 E> Create Outbound Plug 
“Dynp02Comp” 组 件 ( 见 图 3-118), aj “ok” |S wow 


Zoom > 


按钮 。 
14) 输入 引用 组 件 的 名 称 ， 单 击 “Finish” 按 钮 ， 图 3-115 WAWE 
如 图 3-119 所 示 。 


Embed View 


Specify whether you want to create a new view or reuse an existing view, 
if you want to embed the empty view or an interface view of used 


© Embed new view 

© Embed Existing View 

© Embed Empty View 

@ Embed Interface View of a Component Instance 


3-116 选择 能 入 视 岁 类 型 
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If Embed view 一 ee x | 


Embed Interface Yiew of a Component Instance 


Select the interface view you want to embed. You can only choose interface views from used components. 


Embed Interface View of a Component Instance 


Select the component interface view that you want to embed into 'Dynp02CompWin' . 


C Component Instances 


G 


Ly 


3-117 选择 对 应 组 件 


i 


EB New Web Dynpro Component Usage l= js, zx J 
| Specity Web Dynpro Component Usage Properties 
| Enter a new name and choose the component used 


Specify Web Dynpro Component Usage Properties i 


a - = erp j | Enter a new name and choose the component used 


BS 


3-118 添加 对 应 组 件 图 3-119 输入 引用 组 件 的 名 称 


A PRE CIE 3-120), ere S Fi e, 完成 所 有 配 
置 后 ,，“Dynp01Comp” 组 件 中 新 建 的 窗口 中 租 入 了 一 个 接口 视图 ， 这 个 接口 视图 来 源 于 刚 
刚 新 建 的 组 件 。 

i = 
Embed Interface View of a Component Instance a 


Select the interface view you want to embed. You can only choose interface views from used components. 


Embed Interface View of a Component Instance 


Select the component interface view that you want to embed into 'Dynp02CompWin' . 


4 C Component Instances 


4 of Dynp02 <Dynp02CompInterface> 
回 Dynp02CompinterfaceView | 


图 3-120 选择 引用 接口 视图 


16) 为 了 能 够 清晰 地 区 分 两 个 组 件 ， 右 击 “Dynp02CompWin”， 在 弹出 的 快捷 菜单 中 选 
择 “Refactor” 一 “Rename” 命 令 ， 将 组 件 重 命名 为 “Dynp01DisplayWin” (如 图 3-121 
所 示 )。 
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Open 
X Delete 


Repair 


y 


Remove from Context 


Ctrl+Alt+Shift+Down 


Al3-121 选择 重 命名 


17) 在 弹出 的 对 话 框 中 输入 自 定义 的 名 称 ， 单 击 “Finish” 按 钮 ， 如 图 3-122 所 示 。 


Rename Window ii » Mm a 


Specify New Name 
Specify the new name for the Window 'Dynp02CompWin' 


New Name | Dynp01CompDisplayWin 


| © 


ER Ce Eeea| 
l | 


图 3-122 输入 重 命名 名 称 


18) 将 接口 视图 “Dynp02IntV” 重 命名 为 “Dynp01Comp02IntV”， 以 方便 区 分 。 
19) 下 面 简单 编辑 一 下 Dynp02Comp 中 视图 的 内 容 ， 打 开 视 图 ， 在 视图 中 添加 一 个 子 元 
素 ， 并 选择 “Caption” 标题 类 型 ( 见 图 3-123)， 单 击 “OK” 按 钮 。 


New UI Element 
Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 
an Standard 
Action ?| Explanation 
Complex E FormattedTextEdit 
Graphic T] FormattedTextView 
Integration Gee InputField 
Layout G InputTokenizer 
Menu T Label 
Selection E] SectionHeader 
Text E| TextEdit 
Toolbar TextView 
图 3-123 ”插入 文本 标题 


20) 将 


“Text” 属 性 修改 为 “Dynp02Comp View Text”， 如 图 3-124 所 示 。 


21) 最 后 创建 一 个 指向 “Dynp01Comp02IntV” 接 口 视图 的 应 用 。 右 击 “Applications”， 在 
弹出 的 快捷 菜单 中 选择 “Create Application” 命 令 ， 自 定义 应 用 名 称 为 “Dynp02Comp02App”， 
单 击 “Next” 按 钮 ， 如 图 3-125 所 示 。 
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| Application Properties 
Enter the properties for the new application 


Ck Dynp02Comp |[ 国 Dynp02CompView \_ | 


<Type Filter Text> 


Name — Dynp01Comp02App 
Package com.sap.demo.mydynp01.wd.app.dynp01comp02app Browse 


© History os 
T Caption 
国人 
B Action 0 
=i Button 
n- 
© Complex 
(& Graphic i 


® ee eS a Eeea 


BS 


W 


3-124 ”修改 文本 属性 效果 图 3-125 输入 应 用 名 称 


22) 选中 “Use Existing Component” 单 选 按钮 ， 使 用 已 存在 的 组 件 ， 单 击 “Next” 按 
钮 ， 如 图 3-126 所 示 。 


Br E 


| Choose Referenced Web Dynpro Component 
You can either reference an existing Web Dynpro component or create a new one 


Referenced Web Dynpro Component 
| @ Use Existing Component 


© Create a New Component 


® me rm 


图 3-126 选择 组 件 类 型 


23) 随后 选择 “Dynp01Comp”， 同 时 在 接口 视图 中 选择 “Dynp01Comp02IntV”， 单 击 
“Finish” 按 钮 ， 如 图 3-127 所 示 。 


Select References 

Select References for the Application 
Web Dynpro Component | Dynp01Comp - com.sap.demo.mydynp01.wd.comp.dynp0lcomp 
Dynp01CompO2IntV ~ 
St 


Interface View 


Startup plug 


3-127 选择 对 应 的 接口 视图 
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24) 完成 所 有 的 对 象 配 置 后 ， 在 模型 编辑 器 中 可 以 看 到 相互 之 间 的 引用 关系 ， 如 
图 3-128 所 示 。 其 中 “Dynp01Com02App” 应 用 程序 指向 “Dynp01Comp” 组 件 中 指定 的 接 
口 视图 “Dynp01Comp02IntV”， 而 实现 该 接口 视图 的 窗口 “Dynp02CompDisplayWin” 髋 入 了 


“Dynp02Comp” 组 件 中 指定 的 接口 视图 ， 最 终 通 过 运行 应 用 程序 ， 展 示 了 第 二 个 组 件 的 视 
图 界面 。 


P [LocalDevelopment] mydynp01 


cs) Dynp01Comp 


@oynpoicompbisplayivin 
国 pyrpoicompwndor 
本 


Dynp01Co 
Dyn01App RR 


Bs 


3-128 应 用 与 组 件 的 引用 关系 


25) 保存 所 有 修改 ， 并 重新 编译 ， 运行。 右 击 “Dynp01Comp02App”， 在 弹出 的 快捷 菜 
单 中 选择 “Run” 进行 运行 测试 ， 如 图 3-129 所 示 。 


File Edit Navigate Search Project Editor rm Run Window Help č 
CETERA TARIO EER 


D & Search Co | 85. Navigator | 


= & | $| fh ec P [LocalDevel 
4 i [LocalDevelopment] mydynp01 


4 $ Web Dynpro 
4 Œ Applications ce] DARLON 
Ef Dyn01App 
CA Dynpro = z 
> 4 Models ies 
I Component Open Data Modeler 
4 < Components Record 
4 fj Dynp01C X Delete Delete 
EÈ Comp) Copy Ctrl+C 
4 Local Deploy New Archive and Run 
Ta 
AÈ Int 


2 Bint Refactor » 


E| & Remove from Context Ctrl+Alt+Shift+Down 


图 3-129 运行 应 用 的 菜单 选择 
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26) 运行 结果 显示 了 第 二 个 组 件 中 视图 的 内 容 ， 如 图 3-130 所 示 。 


SF) RAE) BBV) CA TAT) 帮助 (H) 


Oynpd2Comp View Text 


图 3-130 运行 效果 


3.3.3 视图 集 与 视图 区 入 


窗口 中 藤 入 视图 有 以 下 几 个 特点 。 

e 舱 入 的 方式 包括 以 下 3 种 : 创建 一 个 新 视图 、 插 入 一 个 已 创建 的 视图 、 通 过 依赖 的 方 
式 添加 其 他 项 目的 接口 视图 。 

o 对 于 通过 任 一 形式 被 钥 入 的 View 组 件 ， 可 以 设置 其 在 Window 是 否 默 认 显 示 的 属性 ， 
当 默 认 显示 设置 为 true 时 ，Window 初始 化 时 会 首先 显示 该 View 组 件 。 

开发 实例 : 

1) 双击 默认 创建 的 窗口 ， 右 侧 默认 打开 窗口 模型 编辑 器 。 窗 口中 已 艇 入 了 

“Dynp01CompView” 和 “Dynp02CompView” 两 个 视图 ， 其 中 02 视图 的 默认 显示 属性 设置 为 
e”， 所 以 在 窗口 的 初始 页 面 中 将 默认 显示 02 视图 的 页 面 内 容 ， 如 图 3-131 所 示 。 


{D Dynp01CompWindowjava LJD ndow i « Dynp01Comp | 四 Dynpo: 
[7 DynpolcompWindow 
| Pn mm i" 
| g Lii a 
| Dynp02co fe 
| mpView my 
| © © © 
| om 
| 
| 5 
| Dynp01CompView 
Navigation | 
区 Problems (m Properties & i Snippets | lil} Infrastructure Console | Ọ) Error Log| A) Tasks 
回 Dynp02CompView 
J 
Settings Property Value 
Properties 
Default Plug None 
Embedded View ID 


器 


图 3-131 ”修改 窗口 中 视图 的 属性 


2) 右 击 空白 处 ,在 弹出 的 快捷 菜单 中 选择 “Create ViewSet” 命 令 ， 在 弹出 的 对 话 框 中 
输入 自 定义 的 视图 集 名 称 ， 并 在 下 方 选择 视图 集 的 布局 ， 如 图 3-132 所 示 。 

3) 选中 新 建 的 视图 集 ， 将 属性 中 的 “columns” 设 置 为 “1”， 如 图 3-133 所 示 。 

4) 右 击 “celll1” 单 元 格 ， 在 弹出 的 快捷 菜单 中 选择 “Embed View” WAWE, P 
“Embed Existing View” 单 选 按钮 艇 入 已 存在 的 视图 ( 见 图 3-134)， 单 击 “Next” 按 钮 。 
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[a New View 


| Specify Yiew Set Properties 


Enter the name for the new view set and choose a view set definition. afd 
| Note that the first view set created is the default view set. | 


| View Set Name 


Vs01 


Definition of View Set | GridLayout 


| Select View Set Definition 


3-132 


E vsol 
cell[1,1] 


cell[2,1] 


3-133 ”修改 视图 集 的 列 数 


5) 选择 “Dynp01CompView”( 见 


PER 


T 


视图 集 的 布局 


Embed View 


Specify whether you want to create a new view or reuse an existing view, 
|| if you want to embed the empty view or an interface view of used components. 


[if Embed Vie 


Select View 


Embed View 


© Embed New View 


@ Embed Existing View 
© Embed Empty View 
© Embed Interface View of a Component Instance 


BS 


3-134 FERAM EE 


KI 3-135), ch “Finish” 按钮 。 


Select one of the existing views that you want to embed 


Select the view that you want to embed 


Dynp02CompView 


图 3-135 
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6) HWA HERE, FE ROTM oct RA “Dynp02CompView” . 
7) 单 击 选中 新 建 的 视图 集 将 默认 显示 属性 修改 为 “true”， 如 图 3-136 所 示 。 


[区 Problems | B Properties 3 a=) Snippets | [E] Infrastructure Console| @ Error Log | | Tasks| ] 


fj Vs01 
Settings Property Value 
4 Properties 
columns 1 
height 
Name Vs01 
rows 2 
Type GridLayout 


图 3-136 修改 属性 


8) 保存 所 有 修改 ， 并 重新 编译 ， 运 行 之 后 ， FRR o cee 
即 可 进行 相关 测试 ， 运 行 效果 如 网 3-137 所 示 。 

注 : 在 窗口 中 的 一 块 显示 区 域内 ， 每 次 仅 能 
显示 一 个 视图 ， 而 视图 集中 每 一 个 单元 格 都 是 一 
块 独立 的 显示 区 域 。 


3.3.4 窗口 的 导航 


在 3.1.5 WP, iM Web Dynpro 创建 向 导 的 方式 自动 地 创建 了 视图 的 导航 并 生成 对 应 
的 按钮 处 理事 件 ， 下 面 对 视 图 导航 进行 手动 配置 。 开 发 过 程 包括 了 创建 插口 、 配 置 导航 连接 
和 完成 逻辑 代码 等 步 又。 

开发 实例 : 

1) 以 上 一 小 节 的 Web Dynpro 项 目 为 例 ， 继 续 进 行 开 发 。 首 先 在 “Properties” 中 找到 
“Plugs” 子 标签 ， 如 图 3-138 所 示 。 


3-137 ”运行 效果 


E Dynp01CompWindow 53 \_ 
ER》 号 Dynpolcompwindow 
g EB vsol [re 
is) 
np02Co 
Dynp01Co 
mpView 
a 
1282, 
Dynp01CompView FPU 
Dynp02Co 
mpView 
Navigation 
区 Problems (C Properties £3 b [& Snippets | [E] Infrastructure Console| 9) Error Log | É Tasks 


E Dynp01CompWindow 
T 


General [e] = [Details Parameters] 
References poio | g || Name Default 
Losin S Default Ty 

Default ype: startup 
Methods = 
Pear is Event Handler: onPlugDefault 


W] Adapt parameters to fit event handler parameters| 


Interface Views Documentation: — 


Miscellaneous 


器 


eal 


3-138 ”查看 插口 属性 
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2) 单 击 加 号 ， 并 选择 “Outbound Plug” 添 加 一 个 出 口 类 型 插口 ， 如 图 3-139 所 示 。 


1 Problems i E Snippets | [E] Infrastructure Console | YJ Error Log] Z 
Dynp01CompWindow 
(General = ails | Parameters 
Refe: @ Inbound Plug 
type filter text ® Outbound Plug fault 
Ee @ Default Type: tu 
Method. o] P 
EEA Event Handler: onPlugDefault 


KI 3-139 ”创建 新 的 插口 


3) 输入 插口 名 称 “Out01”， 单 击 “Finish” 按 钮 ， 如 图 3-140 所 示 。 
“BB New Outbound Plug” W === 


Specity Outbound Plug Properties 
Enter the properties of the outbound plug below. 


图 3-140 输入 插口 名 称 


4) 使 用 相同 的 操作 创建 “0ut02” 插 口 。 
5) 接着 创建 “Inbound” 类 型 插口 ， 鼠 标 悬 停 在 “Dynp02CompView” 视图 上 ， 在 弹出 
的 菜单 中 选择 蓝 色 箭头 按钮 ， 创 建 一 个 “Inbound” 类 型 的 插口 ， 如 图 3-141 所 示 。 


站 Dynp0lLCompWindow 


E vsol 


w cell[1,1] 
回 
Dynp01Co 
mpView 
图 — 
Dynp01CompView cellf2,2) 
图 
Dynp02Co 


mpView 


图 3-141 通过 弹出 菜单 创建 
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6) 按照 上 面 的 操作 创建 “Dynp01CompView” 视 图 中 的 “Inbound” 类 型 插口 。 

7) 定义 插口 之 间 的 导航 连接 ， 单 击 右 边 工 具 栏 中 的 “Link”， 如 图 3-142 所 示 。 

8) 选中 “Out01” 并 拖 忠 连 线 至 “Dynp01CompView” 视 图 的 “Inbound” 插 口 ， 完 成 
导航 连接 的 创建 ， 如 图 3-143 所 示 。 


局 Navigation % 
i InboundPlug 

Outbound Plug 
Link 


Creates a navigatio 


图 3-142 工具 栏 中 的 按钮 图 3-143 创建 视图 导航 


9) 同上 完成 从 “0ut02” 到 “Dynp02CompView” 视 图 的 关联 。 
10) 切换 到 窗口 的 Java 编辑 器 ， 在 “wdDomit( )” 方 法 中 添加 以 下 代码 . 


wdThis. wdFirePlugOut01 ( ) ; 


11) 保存 所 有 修改 ， 重 新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 。 运 行 后 ， 黑 认 显 示 的 
是 “Dynp01CompView” 视 图 的 界面 (Hello World 应 用 ) ， 如 图 3-144 所 示 。 
12) 接着 修改 “wdDolnit( ) ”方法 的 逻辑 : 


wdThis. wdFirePlugOut02( ) ; 


EHF) WE) BBV) RA) IAT) H) 


This is Hello World Application 


图 3-144 运行 效果 1 R| 3-145 


运行 效果 2 


3.3.5 其 他 窗口 类 型 


除了 Web Dynpro 中 标准 的 窗口 以 外 ， 还 可 以 通过 代码 定义 和 调用 其 他 3 种 窗口 类 型 ， 
包括 弹出 窗口 、 外 部 窗口 和 确认 和 窗口 。 

1. 弹出 窗口 

1) 创建 一 个 Web Dynpro 项 目 “Dynp05”， 并 创建 默认 的 组 件 、 窗 口 和 视图 。 随 后 创建 
一 个 新 的 窗口 “Popup_Win_01”， 如 图 3-146 所 示 。 
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2) 接着 创建 一 个 视图 “Dynp05_01Comp_02View”， 如 图 3-147 所 示 。 


4 A Views 
4 本 Windows ， 
中 Dynp05.01Comp.01Win A Dapa ME arp OI 
[| Popup Win 01| 4 一 E] Dynp05_01Comp_02View 


图 3-146 创建 新 窗口 Pe] 3-147 ”创建 新 视 医 


3) 将 创建 的 视图 般 入 到 新 创建 的 “Popup_Win_01” 窗 口中 ， 如 图 3-148 所 示 。 
4) 组 件 控制 器 上 下 文中 创建 一 个 “Win_Info” 结 点 ， 并 创建 一 个 “Win_Ins” 的 特性 ， 
用 于 保存 和 传递 弹出 窗口 的 实例 对 象 ， 如 图 3-149 所 示 。 


Dynp05_01C 
omp_02View [cag Win_ nto 
o Win Ins 
图 3-148 fe AMT DFA 图 3-149 创建 上 下 文 特 性 


5) “Win_Info” 结 点 的 集合 属性 为 “1 .. 1”,， “Win_Ins” 的 类 型 为 “IWDWindow”， 
如 图 3-150 所 示 。 在 组 件 控 制 器 中 创建 之 结 点 后 ， 将 结 点 复制 到 两 个 视图 中 ， 并 添加 上 下 
文 的 映射 。 


Type com.sap.tc.webdynpro.services.session.api.IWDWindow 


= 


图 3-150 ”修改 特性 类 型 


6) 在 原 有 默认 视图 “Dynp05_01Comp_01View” 中 添加 调用 弹出 窗口 的 按钮 ， 如 
图 3-151 所 示 。 
7)“ 明 细 ” 按 钮 处 理事 件 的 逻辑 代码 如 下 : 


IWDWindow createModalWindow = wdComponentAPI. getWindowManager( ). createModalWindow( wd- 
ControllerAPI. getComponent( ). getComponentInfo( ). findInWindows("Popup_Win 01" ) ) ; 
createModalWindow. setWindowSize( 200, 200) ; // 定 义 Window Size 

createModalWindow. setWindowPosition( 500, 100) ; // 定 义 Window Position 
createModalWindow. setTitle( "明细" ) ; 

createModalWindow. show( ) ; 

// 保 存 window 实例 

TWin_InfoNode nodeWinInfo = wdThis. wdCetDynp05_01CompController( ). wdGetContext( ). nodeWin 
_Info( ) ; 

node WinInfo. currentWin_InfoElement( ). setWin_Ins( createModalWindow ) ; 


8) 在 新 建 的 “Dynp05_01Comp_02View” 视 图 中 添加 一 些 表 单 属 性 以 及 一 个 关闭 按钮 ， 
如 图 3-152 所 示 。 


图 3-151 添加 按钮 效果 图 3-152 ”添加 表单 效果 
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9)“ 明 细 ” 按 钮 处 理事 件 的 逻辑 代码 如 下 : 


// 通 过 Component Controller 上 下 文 获取 Window 实例 
IWDWindow winIns = wdThis. wdGetDynp05_01 CompController( ). wdGetContext( ) 
. nodeWin_Info( ). currentWin_InfoElement( ). getWin_Ins( ); 
// 关 闭 窗口 
winIns. destroyInstance( ) ; 
10) 保存 所 有 修改 ， 重 新 编译 运行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效果 如 图 3-153 所 
示 。 默 认 看 到 的 是 视图 01。 
11) 单 击 “ 明 细 ” 按 钮 ， 即 可 看 到 弹出 窗口 ， 如 图 3-154 所 示 。 


图 3-153 ”运行 效果 图 3-154 单 击 “ 明 细 ” 按 钮 后 的 运行 效果 


2. 外 部 窗口 
外 部 窗口 是 指 通 过 打开 新 的 浏览 带 窗 口 ， 在 新 的 浏览 器 窗 口中 显示 URL 链接 对 应 的 内 
R, AEF Web Dynpro 的 标准 窗口 。 


开发 实例 : 
> 前 
1) 继续 使 用 之 前 创建 的 Dynp05 项 Popup External Window 


External Window”， 如 图 3-155 所 示 。 
2) 编写 按钮 对 应 事件 的 处 理 逻 辑 : 


Map map = new HashMap( ) ; // 构 造 请 求 参数 
map. put("ID" , "C0010" ) ; 


"nn 


String queryString = "" ; 


String url =""; 
try | 
queryString = WDURLGenerator. getQueryString( map, "UTF-8"); /根据 Map 转化 为 Query- 
// String 
url = WDURLGenerator. getApplicationURL(" demo. sap. com/mydynp05" , 
"Dynp05_01Comp_02App" ) ; // 根 据 DeployObject 与 


// Application 获取 标准 的 ApplicationURL 

catch( Exception e) | 

// TODO Auto - generated catch block 

// e. printStackTrace() ; 

wdComponentAPI. getMessageManager( ). reportException(e. getMessage( ) ) ; 
logger. errorT(e. getMessage( ) ) ; 

return ; 

| 

IWDWindow createNonModalExternal Window = wdComponentAPI 

. getWindowManager( ). createNonModalExternal Window ( url, 
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queryString, true) ; // 创 建 External Window ,请 求 访问 的 方式 为 POST 
createNonModalExternalWindow. show( ) ; // 窗 口 显 示 


3) 在 视图 02 中 的 “wdDolInit” 初 始 化 方法 中 打印 参数 标识 ， 添 加 代码 如 下 : 


String parameter = 


WDProtocolAdapter. getProtocolAdapter( ). getRequestObject( ). getParameter("ID" ) ;// 获 取 Pa- 
//rameter ID Value 


wdComponentAPI. getMessageManager( ). reportSuccess( parameter) ; 


4) 保存 所 有 修改 ,重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效果 如 图 3-156 
所 示 。 


| 明细 | Popup External Window 


图 3-156 运行 效果 


5) 单 击 “Popup External Window” 按 钮 ， 弹 出 的 明细 页 面 打 印 了 参数 的 标识 ， 如 
图 3-157 所 示 。 


B co0010 


id: 
name: 


图 3-157 运行 效果 


3. 确认 窗口 

确认 窗 是 Web Dynpro 中 封装 过 的 窗口 〈 对 话 框 ) ， 通 过 API 调用 可 直接 弹出 确认 窗口 ， 
确认 窗口 的 确认 与 取消 的 逻辑 自 定义 。 

开发 实例 : 


1) 继续 使 用 的 之 前 视图 ， 添 加 一 个 “Popup Confirmation Window” 按钮 ， 如 图 3-158 
所 示 。 


Popup External Window || Popup Confirmation Window 
到 3-158 ”添加 按钮 效果 


2) 编写 按钮 逻辑 ， 代 码 如 下 ; 


// 创 建 Dialog Window ,默认 添加 的 确认 选项 

IWDConfirmationDialog createConfirmationWindow = wdComponentAPI. getWindowManager ( ) 
. createConfirmationWindow ( " 是 否 确 认 ?" ,wdThis. wdGetOkAction() , "确认 " ) ; 

// 添 加 取消 的 选项 

createConfirmation Window. addChoice( wdThis. wdGetCancelAction( ) ," 取消 " ) ; 

// 弹 出 Window 


createConfirmation Window. show( ) ; 


3) 创建 确认 对 话 框 中 需要 使 用 的 确认 与 取消 的 自 定义 事件 “Ok” 与 “Cancel”， 如 
图 3-159 所 示 。 
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4) 编写 确认 逻辑 ， 打 印 成 功 提醒 消息 : 


wdComponentAPI. wdCetMessageManager( ). reportSuccess( "OK" ) ; 


5) 保存 所 有 修改 ， 重 新 编译 ， 运 行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效 果 如 图 3-160 
所 示 。 


ae Cancel 

ea Confirm 

eae External _ —— 

ok) * rr J Pop Conon Wino] 


Al3-159 添加 自 定义 方法 图 3-160 ”运行 效果 


6) 单 击 “Popup Confirmation Window” 即 可 看 到 弹出 的 “确认 ”对 话 框 ， 如 图 3-161 
所 示 。 
7) 单 击 “ 确 认 ” 按 钮 ， 窗 口 关 闭 并 出 现 打印 成 功 提醒 消息 ， 如 图 3-162 所 示 。 


W ok 
“确认 ”按钮 后 的 效果 


TEK 


EL 


TE 


ch 
oft 


6 按钮 效果 Al3-162 À 


Al3-161 à 


3.4 ”组 件 控制 器 


如 果 说 之 前 的 视图 和 窗口 的 介绍 还 可 以 算是 “MVC” 中 “V” 的 部 分 ， 其 至 熟练 的 开 
发 人 员 不 需要 编写 任何 代码 就 能 完成 “V” 的 一 些 简单 设计 ， 本 节 的 组 件 控制 颖 ( Compo- 
nent Controller) 则 来 到 了 “MVC” 中 的 “C” 部 分 ,将 会 不 可 避免 地 涉及 Web Dynpro 代码 
的 编写 。 

组 件 控制 器 会 在 创建 组 件 时 自动 生成 ， 作 为 整个 组 件 的 主 控制 器 对 数据 进行 处 理 。 简 单 
地 说 ， 视 图 窗口 是 Web Dynpro 对 应 组 件 的 脸 ， 而 组 件 控制 器 则 是 组 件 的 大 脑 。 

在 Web Dynpro 设计 模式 中 ， 视 图 、 窗 口 以 及 其 他 控制 器 都 可 以 通过 与 组 件 控制 器 的 上 
下 文 映射 (Context Mapping) 实现 数据 共享 ， 组 件 控制 需 在 逻辑 处 理 、 数 据 传递 中 起 到 了 控 
制 与 转换 的 作用 ; 同时 组 件 控制 器 或 自 定 义 控 制 器 〈Custom Controller) 直接 与 模型 数据 源 
交互 ， 并 将 处 理 后 的 数据 传递 给 视图 ， 最 终 成 为 与 用 户 直接 交互 的 UI 层 数 据 。 


3.4.1 组 件 控 制 器 的 属性 


从 Web Dynpro 工程 的 目录 双击 组 件 控 制 器 ， 会 自动 打开 对 应 的 模型 编辑 器 ; 如 需 编 辑 
控制 器 源 代 码 ， 则 先 右 击 组 件 控制 器 ， 在 弹出 的 快捷 菜单 中 选择 “Open” 一 “Java Editor” 
即 可 打开 Java 编辑 融 查 看 源 代码 ， 如 图 3-163 所 示 。 

需要 说 明 的 是 ， 虽 然 在 操作 时 双击 打开 的 是 组 件 控制 器 ， 但 如 果 仔 细 看 会 发 现 右 上 方 打 
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Documentation: 


图 3-163 组 件 控制 需 的 属性 


开 的 模型 编辑 器 其 实 是 整个 组 件 〈 图 3-163 中 为 “Dynp01Comp” 组 件 ) 的 模型 编辑 器 ， 如 
在 编辑 器 中 选中 视图 或 其 他 对 象 ， 则 右 下 方 的 “Properties” 下 也 会 切换 显示 为 相应 对 象 的 
所 有 属性 。 

组 件 控制 咒 中 包含 的 属性 子 标签 及 功能 说 明 见 表 3-5。 


表 3-5 组 件 控制 器 中 包含 的 属性 子 标 签 及 功能 说 明 


属性 子 标签 功能 说 明 
General 组 件 控制 器 的 一 般 信息 
References 其 他 组 件 的 引用 列表 
Context 组 件 控制 器 的 上 下 文 
Methods 组 件 控制 器 的 自 定义 方法 
Event Handlers 组 件 控制 器 的 事件 处 理 器 
Events 自 定义 事件 


3.4.2 组 件 控 制 占 的 生命 周期 


组 件 控制 器 的 生命 周期 与 其 对 应 的 组 件 实例 的 生命 周期 是 一 致 的 ， 甚 至 大 部 分 情况 下 ， 
可 以 说 组 件 控制 器 的 生命 周期 决定 了 整个 组 件 的 存在 ， 即 组 件 控制 器 被 调用 并 实例 化 ， 同 时 
创建 相应 组 件 的 实例 ， 最 后 在 控制 器 退出 时 销毁 组 件 实例 。 以 下 是 整个 组 件 控制 器 的 生命 周 
期 中 可 能 会 执行 到 的 标准 方法 。 
© wdDomit( ) : 这 是 所 有 控制 器 〈 包 括 组件 控 制 器 和 视图 控制 器 ) 的 默认 初始 化 方法 ， 
且 在 实例 初始 化 时 仅 执行 一 次 ， 因 此 对 于 控制 器 中 数据 的 初始 化 或 者 变量 的 默认 值 设 
定 都 在 这 个 方法 中 完成 。 
© wdDoExit( ) : 与 wdDolInit( ) 相 对， 该 方法 在 每 个 控制 器 结束 时 执行 。 视 图 的 退出 场景 
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有 很 多 ， 包括 视图 失效 、 窗 口 关闭 、 视 图 切换 等 。 该 方法 也 是 每 个 控制 器 实例 的 
出 口 。 

e wdDoPostProcessing( ) : 该 方法 仅 在 组 件 控制 右 中 存在 。 由 于 在 复杂 的 Web Dynpro 应 
用 中 (如 跨 组 件 或 跨 工程 的 方法 调用 ) ， 数 据 可 能 来 自 于 多 个 组 件 ， 因 此 为 了 程序 更 
有 效 地 运行 ， 该 方法 可 以 实现 相关 代码 ， 使 其 在 数据 处 理 之 前 就 对 数据 提前 进行 有 效 
性 验证 。 

© wdDoBeforeNavigation( ) : 该 方法 也 仅 在 组 件 控制 句 中 存在 。 当 一 个 视图 控制 器 触发 一 
个 outbound 的 插口 时 ， 它 并 不 是 一 个 人 在 战斗 ,很 可 能 有 许多 视图 控制 器 都 触发 了 视 
图 切换 的 动作 ， 这 些 请 求 随后 会 进入 一 个 处 理 队 列 ， 而 这 个 方法 可 以 实现 相关 代码 ， 
对 队列 中 导航 之 前 发 生 的 逻辑 动作 进行 处 理 (如 导航 事件 优先 级 ) 。 

e isCurrentRoot 布尔 参数 : 由 于 上 述 两 个 方法 会 涉及 多 个 组 件 的 交互 ， 而 仅 有 Web Dyn- 
pro 运行 时 默认 显示 的 接口 视图 对 应 所 在 的 组 件 才 能 被 称 为 根 组 件 (root component) , 
因此 该 参数 用 于 区 分 此 类 组 件 。 

组 件 中 视图 、 窗 口 、 组 件 控制 器 的 标准 初始 化 方法 执行 顺序 如 下 。 

1) ACEP AeA eat: “Component Controller” 的 “wdDolInit” 方 法 。 

2) 默认 窗口 的 初始 化 :“Window” 的 “wdDolnit” 方 法 。 

3) 默认 视图 的 初始 化 :“View” 的 “wdDomit” 方 法 。 

4) 视图 的 默认 校 验方 法 :“View” 的 “wdDoBeforeAction” 方 法 。 

5) 视图 UIL 元 素 对 应 的 方法 : HEX “Action” o 

6) 视图 的 默认 变更 方法 :“View” 的 “wdDoModifyView” 方 法 。 

注 : 更 详细 的 视图 标准 方法 执行 顺序 请 参考 3. 1. 1 节 的 开发 实例 。 

开发 实例 : 

1) 切换 到 组 件 控 制 及 wdDomit( ) ， 右 击 “Dynp01Comp Component Controller”， 在 弹出 

的 快捷 菜单 中 选择 “Open” 一 “Java Editor”， 并 添加 以 下 代码 ， 如 图 3-164 所 示 。 


wdComponentAPI. getMessageManager ( ) . reportSuccess ( " Executer Component Controller wdDoInit 


人 


<&& Dynp01Comp 加 Dynp01Comp,java 5 
on * / 
public Dynp01iComp (IPrivateDynp0iComp wdThis) 
{ 
this.wdThis = wdThis; 
this.wdContext = wdThis.wdGetContext (); 
this.wdControllerAPI = wdThis.wdGetAPI(); 
this.wdComponentAPI = wdThis.wdGetAPI() .getComponent () ; 


04 


//@@begin javadoc:wdDoInit () 
/** Hook method called to initialize controller. */ 
//@@end 


1109 public void wdDoInit() 

111 { 

112 //@@begin wdDoInit () 

11 wdComponentAPI .getMessageManager () .reportSuccess ( 
"Executer Component Controller wdDoInit():"); 


图 3-164 添加 代码 
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2) 保存 所 有 修改 ,重新 编译 、 


运行 se f 即 可 进 行 “ Dynp01 App ” W] Executer Component Costroler wdDonir) 
ois es sha peli as ah [E trecute "Window wadont 
应 用 的 IB 17 测 试 ， IB 17 效 果 如 [E Execute 02View weDomt 
图 3-165 所 示 é 图 Execute “Window wd0oModty View 
通过 图 3-165 的 运行 结果 可 以 看 fj Execute "O2View weDoMedifyView 
到 ， 当 程 序 运行 并 创建 一 个 组 件 的 实 3-165 ”运行 效果 


例 之 后 ， 会 先 执行 组 件 控制 器 初始 化 
方法 ， 再 执行 窗口 的 初始 化 ， 最 后 执行 视图 的 初始 化 。 


3.4.3 组件 控制 如 的 标准 类 
与 视图 控制 器 创建 时 类 似 (参照 3.1.2 节 )， 组 件 控制 器 创建 的 同时 自动 生成 的 标准 类 


包括 [Public < NAME > Comp, 、IPrivate < NAME > Comp、Internal < NAME > Comp FI < NAME > 


Comp. 
组 件 控制 带 的 标准 类 默认 创建 目录 如 下 : 


< NWDS directory > \workspace. jdi\LocalDevelopment \ DCs \ 
< package name > \ < project name > \_comp\gen_wdp\ packages \ 
< package directory > \wd\comp\ < component name > \wdp 


组 件 控制 器 相关 标准 类 和 继承 关系 如 图 3-166 所 示 。 


继承 


getComponent() 


wdGetAPI() 


只 存在 于 非 视 
图 的 控制 器 中 


对 组 件 内 其 他 
控制 器 可 见 * 自 实现 以 及 内 部 的 控制 器 
---------4-------}------------------4--- 类 可 以 被 看 作 一 个 程序 块 
GD exter 
wdControllerAPI}| ”wdThis | | 实现 wdControllerAPI yD 生成 控制 器 API 


含 自 定义 代码 的 


控制 器 类 


Custom 
Controller 


图 3-166 组 件 控制 咒 相 关 标 准 类 和 继承 关系 


以 之 前 的 开发 实例 mydynp01 为 例 ， 对 应 的 组 件 控制 需 的 标准 类 的 目录 如 下 : 
. . \workspace. jdi\LocalDevelopment\DCs\demo. sap. com\mydynp01 \_comp \gen_wdp \ pack- 
ages \com \sap \demo\mydynp01 \wd \ comp \dynp01 comp \wdp 
è [Public < NAME > Comp: 包含 所 有 组 件 控 制 器 相关 APL 以 及 数据 结构 定义 ,代码 自动 
生成 。 
e [Private < NAME > Comp; 继承 了 [Public < NAME > Comp 接口 ， 也 是 组 件 控制 器 中 
wdThis 对 应 的 实例 接口 ， 代 码 自动 生成 。 
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© Internal < NAME > Comp: 实现 [Private < NAME > Comp 接口 同时 继承 了 CCICompo- 
nentController 标准 类 ， 并 实现 了 IGCIComponentDelegate 标准 接口 ， 代 码 自 动 生 成 。 

e < NAME > Comp: Web Dynpro 为 了 更 好 地 实现 对 标准 程序 与 自 定义 程序 的 剥离 ，In- 
ternal < NAME > Comp 采用 了 另外 一 种 设计 模式 ， 在 初始 化 时 会 生成 包含 所 有 可 自 定 
义 方 法 的 < NAME > Comp 类 ， 开 发 者 在 编辑 组 件 控制 器 时 ， 不 是 在 编辑 Internal 

<NAME > Comp 而 是 在 编辑 <NAME > Comp 类 实例 。 


3.4.4 组 件 控制 堪 的 上 下 文 


组 件 控制 器 的 上 下 文 (Context) 是 对 组 件 控制 器 数据 结构 的 定义 ， 所 有 上 下 文中 存放 
的 数据 都 是 私有 的 ， 只 有 在 与 其 他 组 件 或 控制 器 完成 上 下 文 映射 或 者 对 外 声明 以 后 ， 才 能 被 
其 他 组 件 使 用 。 上 下 文 的 基本 介绍 、 属 性 以 及 操作 的 API 都 与 3. 1 节 中 视图 的 上 下 文 一 致 ， 
所 以 本 节 不 再 重复 介绍 上 下 文 的 概念 ， 重 点 从 组 件 控制 器 的 实际 应 用 进行 介绍 。 

从 设计 的 角度 来 讲 ， 视 图 的 上 下 文 用 来 绑 定 视图 的 页 面 元 素 和 进行 属性 控制 ， 自 定义 控 
制 絮 的 上 下 文 用 来 与 模型 进行 数据 交互 ， 而 组 件 控制 器 的 上 下 文 更 多 的 是 用 于 中 转 与 控制 ， 
而 并 非 是 组 件 的 数据 源 。 上 下 文 可 以 作为 控制 器 自身 的 一 个 小 型 本 地 数据 库 ， 但 真正 的 数据 
源 更 多 还 是 来 自 于 各 种 各 样 的 模型 ， 组 件 控 制 器 的 上 下 文 只 有 在 结合 了 U 层 的 数据 访问 或 
者 后 台 模 型 的 数据 交换 ， 才 会 体现 意义 ， 毕 竟 核 心 的 逻辑 处 理 还 是 需要 在 组 件 控制 器 中 
完成 。 

1. 上 下 文 的 映射 

组 件 控 制 器 的 上 下 文 在 整个 Web Dynpro 工程 的 数据 结构 中 起 到 控制 与 中 转 的 作用 ， 其 
他 的 组 件 可 以 通过 组 件 控 制 器 实现 数据 的 共享 与 传递 ， 上 下 文 的 映射 就 是 其 他 组 件 直 接 与 组 
件 控制 器 作为 数据 共享 的 主要 方式 。 

这 种 映射 方式 的 优点 : 通过 映射 关系 ， 所 有 相关 的 控制 器 都 被 允许 使 用 来 自 于 上 下 文 的 
源 数据 ; 在 这 样 的 要 求 下 仍然 只 需要 维护 一 份 数 据 ， 不 同 控 制 器 中 处 理 上 下 文 的 数据 将 通过 
映射 关系 进行 同步 ; 数据 可 以 进行 选择 性 地 映射 ， 避 免 元 余 结构 和 字段 的 出 现 ， 使 得 其 他 控 
制 絮 的 运行 更 为 有 效 

要 注意 的 是 ， 视 图 控制 器 的 上 下 文 并 不 允许 成 为 映射 源 ， 从 MVC 的 架构 来 说 ， 视 图 控 
制 器 的 目的 是 管理 视图 的 UI 元素、 导航 链接 事件 等 内 容 ， 而 不 是 处 理 数据 ， 所 以 一 般 来 说 
都 是 以 组 件 控制 器 的 上 下 文 为 映射 源 ， 从 技术 角度 来 看 ， 由 于 视图 控制 器 不 存在 IPublic < 
NAME > 类 型 的 公共 接口 ， 而 IPublic < NAME > 接口 的 数据 结构 为 公共 外 部 类 可 访问 的 结构 ， 
因此 视图 控制 器 的 数据 结构 具有 受 限 制 访问 权限 ， 不 能 作为 映射 源 。 

不 同 控制 器 之 间 相 同 结构 类 型 的 上 下 文 做 了 映射 之 后 ， 上 下 文中 的 数据 保存 在 源 结 点 
中 ， 所 有 对 映射 结 点 或 源 结 点 的 操作 都 集中 于 源 结 点 的 数据 ， 并 通过 这 种 方式 达到 不 同 控制 
器 所 使 用 数据 的 一 致 。 控 制 器 上 下 文 的 映射 关系 如 图 3-167 所 示 。 

图 3-167 中 左 侧 的 两 个 方 框 都 是 视图 控制 器 ， 右 侧 分 别 为 自 定义 控制 器 和 组 件 控制 器 ， 
映射 入 头 附 件 的 字母 “0” 表示 “Original” 源 结 点 ， 而 字母 “M” 表示 “Mapped” 映 射 结 
点 。 通 过 图 3-167 可 以 看 到 ; 

1) 不 允许 视图 控制 器 之 间 进 行 上 下 文 映射 ， 因 为 视图 控制 器 的 上 下 文 并 不 能 获取 源 
数据 。 

2) 不 允许 自 定 义 控制 器 指向 视图 控制 器 的 上 下 文 映射 。 
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View Custom Component 
Controller Controller Controller 


Context Context 
o 


图 3-167 上 下 文 映射 关系 


3) 允许 从 视图 控制 吉 指 向 自 定 义 控 制 带 以 及 组 件 控 制 铝 的 上 下 文 映 射 关 系 。 


4) 允许 从 


目 定 义 控 制 絮 指向 组 件 控 制 絮 的 上 下 文 映射 关系 。 


2. 视图 与 组 件 控制 器 

对 于 上 下 文中 结 点 的 上 映射， 映射 结 点 使 用 源 结 点 作为 数据 源 ， 而 映射 结 点 的 数据 与 源 结 
点 始终 保持 一 致 。 上 下 文 结 点 的 映射 有 两 种 不 同 的 方式 ， 两 个 结 点 的 属性 也 可 以 根据 映射 方 
式 的 不 同 会 产生 差异 。 两 种 映射 方式 分 别 为 “Collection and selection” 集合 与 选择 属性 、 
“Collection Only” 仅 集合 属性 ， 默 认 情 况 下 映射 类 型 为 集合 与 选择 属性 。 


1) 集合 与 选择 属性 : 这 种 方式 代表 映射 结 点 与 源 结 点 的 属性 〈 包 括 集合 属性 、 选 择 属 


PE) 完全 一 致 ， 
2) 仅 集合 


并 以 源 结 点 为 基准 。 
BHE: 这 种 方式 代表 映射 结 点 与 源 结 点 的 属性 中 只 有 集合 属性 保持 一 致 ， 选 


择 属 性 可 以 单独 设置 。 


另外 ， 对 于 视图 与 组 件 控制 器 的 上 下 文 映 射 的 实际 操作 ， 简 单 来 说 依次 是 : 在 视图 和 组 
件 控制 器 中 分 别 创建 上 下 文 ， 建 立 引 用 关系 ， 完 成 具体 映射 的 配置 。 而 在 实际 操作 过 程 中 ， 


“建立 引用 关系 


”也 有 3 种 不 同 的 配置 方式 来 实现 同样 的 效果 : 


1) 在 组 件 的 模型 设计 器 里 通过 数据 链接 的 连 线 建立 关系 。 在 模型 设计 器 中 ， 单 击 “ Da- 
ta Link” 数 据 链 接 ， 单 击 视图 并 拖 电 至 组 件 控制 器 ， 如 图 3-168 所 示 。 


2) 在 视图 
所 示 。 


y Component 


Usage 


日 
Dynp02Co 
mpView 
â 
(& Data Sources < 


48 Web Service 


Component ‘yp 
A Controller 
13-168 创建 引用 关系 


属性 的 “References” 子 标签 中 ,添加 对 组 件 控制 器 的 引用 ， 如 图 3- 169 


Dynp01_PLO1_ View 


Required Controllers 
General = : 
| Displays the required controllers 
References 


Context | Controller Type Controller Name | 


Event Handlers | 


图 3-169 添加 引用 对 象 
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3) 在 创建 视图 的 上 下 文 后 ， 直 接 对 其 编辑 映射 关系 : 右 击 上 下 文 结 点 ， 在 弹出 的 快捷 
菜单 中 选择 “Edit Context Mapping”， 编 辑 上 下 文 映 射 ， 如 图 3-170 所 示 。 

开发 实例 : 

1) 接 下 来 在 组 件 控 制 器 上 下 文中 完成 一 组 数据 定义 ， 以 “mydynp01” 项 目 为 例 ， 配 置 
并 测试 映射 完成 后 的 实际 效果 ， 如 图 3-171 所 示 。 


E Dynpol_PLO1 View 


General Edit\View: @ Context Properties © Context Mapping 


Oewre 


4 O Context 
> DO Per 


New 


Edit Context Mapping... 


Dynp01_PL T | Dynp01_PL 
Delete Context Mapping 01_View 02_View 


Miscellaneous Edit Model Binding... 


Delete Model Binding 


3-170 编辑 上 下 文 映 射 图 3-171 原 Web Dynpro 效果 


2) 切换 到 视图 上 下 文 界面 ， 编 辑 “Per” 结 点 ， 添 加 “string” 字 符 串 类 型 的 name 与 
desc 两 个 特性 ， 修 改 “id” 元 素 的 属性 为 不 可 计算 ， 如 图 3-172 所 示 。 


国 Dynp02CompView 
General Edit\View: @ Context Properties © Context Mapping 
References Ci @ F E | Property Value 
Contoxt 4 © Context Documentation 
Methods Quick info 
Event Handlers Technical Document 
Actions Misc 

Collection Cardinalit 1..1 
Bigss — 日 name Initialize Lead Select true 
Miscellaneous Nane Per 


图 3-172 修改 上 下 文 


性 


eal 


3) 右 击 “Per” 结 点 ,在 弹出 的 快捷 菜单 中 选择 “复制 ”， 打 开 组 件 控制 器 的 上 下 文 ， 
右 击 “Context”， 在 弹出 的 快捷 菜单 中 选择 “粘贴 ” ， 完 成 在 组 件 控制 器 上 下 文中 定义 与 视 
图 控制 器 上 下 文 结 构 一 致 的 结 点 ， 如 图 3-173 所 示 。 


<< Component Controller 


General Edit\View: @ Context Properties © Context Mapping 

References Ogre Property Value 

Context 4 ©) Context Documentation 

Methods par Quick info 

Event. Handlers. a Technical Document 

ae as Misc 

——— Collection Cardinalit 1..1 
Initialize Lead Select true 
Name Per 
Selection Cardinality 0.1 


图 3-173 在 组 件 控制 器 中 创建 上 下 文 
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4) WA ERE a, STOP Ze A, SE AU “Data Link” 进 行 数据 链 
fk, Haat “DynpO2CompView” Ff Hi R HE 2k Æ “Component Controller”, 4 K| 3 - 174 
所 示 。 


Remit Dynp0lIComp 22 Palette 


( mpInterf... f = N Select 
| 


@aModel Usage 


A 


“jy Component 


| 
© 
国 $ A Usage 
Dynp01Co Component Dynp02Co [7 Data Link | 
are eee icon ov Coss 
4 & & = 
© Data Sources © 


$ Web Service 


® EB 


§3 Java Bean 


图 3-174 创建 数据 链接 


5) 拖 忠 后， 自动 弹出 上 下 文 映射 窗口 。 左 侧 显 示 的 是 视图 控制 占 的 上 下 文 ， 右 侧 显 示 
的 是 组 件 控制 器 的 上 下 文 ， 上 方 还 有 文字 提醒 ， 如 图 3-175 所 示 。 如 果 先 在 组 件 控 制 絮 中 
定义 上 下 文 ， 则 直接 可 以 通过 上 下 文 映 射 时 在 视图 控制 器 中 创建 对 应 上 下 文 并 完成 上 下 文 
映射 。 


Context Mapping 一 “er ve 


Selectthe context elements to map 


Drag from right to left to create and map a new element in the left tree. 
‘| Drag from left to right to map an existing element. 


| Dynp02CompView Dynp01Comp 
4 © Context [ aa © Context 
> [CA Per| [ Per 


D name 


3-175 ”编辑 上 下 文 映射 


6) 单 击 左 侧 的 “Per” 结 点 并 拖 忠 至 右 侧 组 件 控制 器 的 结 点 上 ， 系 统 弹 出 详细 映射 规 
则 定义 的 窗口 ， 如 图 3-176 所 示 。 

7) 选择 希望 做 映射 的 特性 ， 单 击 “Finish” 按 钮 ， 如 图 3-177 所 示 。 

8) 完成 映射 元 素 选择 后 ， 在 上 下 文 映射 窗口 中 会 显示 已 映射 元 素 之 间 的 连接 线 ( 见 
图 3-178) ， 确 认 无 误 后 单 击 “Finish” 按 钮 。 

9) 再 次 切换 到 视图 的 上 下 文 界 面 ,“Per” 结 点 的 图 标 上 已 多 了 一 个 小 箭头 ， 表 示 已 映 
射 ; 同时 它 的 属性 中 也 已 标记 “Mapping Path” 映射 路 径 和 “Mapping Type” 映射 类 型 ， 如 
图 3-179 所 示 。 由 于 映射 类 型 是 “集合 与 选择 属性 ”， 因 此 该 结 点 的 集合 属性 与 选择 属性 都 
不 可 修改 。 


8l 
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Select the context elements to map 


Rename elements by clicking the corresponding item in the list on the right 


4 EO Context 
4 转口 Per 
© a desc 
回 @ id 
© B name 
B name 


Mapped Element 


Per 


[V] Resolve mappings according to context element name. Existing mappings will be replaced 


[¥] Automatically resolve name clashes 


图 3-176 选择 映射 的 上 下 文 结 点 


Select the context elements to map 


Rename elements by clicking the corresponding item in the list on the right 


MO Context 
au 


Mapped Element 


name 


图 3-177 选择 映射 的 上 下 文 特性 


[2 Context Mappino == == 


Select the context elements to map 


Drag from right to left to create and map a new element in the left tree. 
Drag from left to right to map an existing element. 


Dynp02CompView 


图 3-178 确认 映射 对 象 


国 DynpO2CompView 


‘General | Ci & F © | Property Value 
References [a © Context Documentation 
b ick info 
Technical Documentation 
M 5 Mapping 
Event Handlers Mapping Path Dynp01Comp.Per 
Actions Mapping Type Collection and selection 
Plugs Misc 
sea Collection Cardinality 1.1 
一 一 一 一 一 一 一 -| Initialize Lead Selection true 
Name Per 
Selection Cardinality 0..1 
Singleton true 
Structure 
Typed Access Required true 
图 3-179 ”映射 类 型 属性 
BE Sy “7 [si “ ” ao 
10) 下 面 进 行 修 改 测 试 。 打 开 组 件 控制 器 上 下 文 ， 分 别 修改 “Per” 结 点 的 集合 属性 与 
y SZ 
选择 属性 ， 如 图 3-180 所 示 。 
| Component Controller 
General Edit\View: @) Context Properties © Context Mapping 
References ó g f E | Property Value 
Context 4 © Context | 4 Documentation 
Methods 4) Per | Quick info 
Event Handlers 日 desc | Technical Documentation 
aes 日 id | 4 Misc 
日 name Collection Cardinality 0..n 
Initialize Lead Selection false 
Name 
Singleton 


11) 在 保存 上 述 修 改 后 ， 打 开 视 图 上 下 文 进行 查看 ， 映 射 结 点 


如 图 3-181 所 示 


图 3-180 修改 组 件 控制 器 中 的 上 下 文 属性 


o 


E Dynp02CompView 


General Edit\View: @ Context Properties © Context Mapping 
References, Ci & F G | Property Value 
Context 4 © Context Documentation 
Methods >a Per| Quick info 
Event Handlers 日 name Technical Documentation 
Aai Mapping 

Mapping Path Dynp01Comp.Per 
Plugs Mapping Type Collection and selection 
Miscellaneous Misc 

Collection Cardinality 0..n 

Initialize Lead Selection false 

Name Per 

Singleton true 

3-181 查看 视图 中 的 上 下 文 属性 


的 属性 也 已 同步 修改 ， 


读者 可 以 自行 尝试 将 视图 控制 器 上 下 文 的 映射 类 型 修改 为 “Collection Only” NESA 
属性 ， 然 后 再 修改 组 件 控制 器 中 的 上 下 文 属 性 ， 看 看 视 岁 控制 器 中 是 否 会 同步 发 生 改 变 。 
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3. 视图 与 视图 

Web Dynpro 项 目 内 组 件 之 间 的 引用 原理 与 类 之 间 的 引用 非 党 相似， 组 件 可 以 访问 引用 
组 件 的 数据 与 方法 ， 组 件 中 的 4 种 控制 器 中 ， 除 了 视图 控制 器 不 能 被 引用 之 外 ， 其 他 控制 器 
之 间 都 可 以 相互 引用 。 引 用 同时 也 是 上 下 文 映 射 的 前 提 ， 视 图 作为 终端 访问 组 件 ， 其 上 下 文 
结 点 不 能 作为 源 结 点 ， 视 图 控制 器 的 Java 类 内 部 也 不 建议 有 复杂 的 业务 逻辑 (除数 据 层 的 
业务 迎 辑 外 ， 建 议 全 部 封装 为 组 件 控制 器 的 操作 单元 )， 所 以 视图 与 视图 之 间 、 视 图 与 其 他 
组 件 之 间 的 交互 都 是 通过 组 件 控制 带 来 完成 的 ， 视 图 不 允许 被 直接 引用 。 

引用 的 方式 包括 以 下 两 种 : 

e Data Link; 直接 通过 Data Link 使 两 个 组 件 进行 关联 。 

© References 属性 : 在 Properties 属性 中 ，References 用 来 添加 被 引用 的 其 他 组 件 。 

开发 实例 : 

1) 以 mydynp01 工程 为 例 ， 之 前 完成 的 是 视图 间 的 切换 ， 如 果 进 一 步 地 还 需要 在 切换 
时 传递 参数 ， 则 需 进 行 开 发 配置 ， 如 图 3-182 所 示 。 

2) 首先 需要 在 Dynp01_PLO1_View 和 Dynp01_PLO2_View 中 定义 数据 存放 的 上 下 文 ， 并 且 
完成 视图 与 控制 器 的 映射 ， 如 图 3-183 所 示 。 根 据 上 一 小 节 的 配置 , 已 完成 了 PL02 视图 的 上 
下 文 映 射 ， 下 面 来 完成 PLO1 视图 的 上 下 文 映射 。 首 先 将 “Per” 绪 点 复制 并 粘贴 到 “Dynp01_ 
PLO1_View” 视 图 的 上 下 文中 ， 右 击 “Per” 结 点 ， 在 弹出 的 快捷 菜单 中 选择 编辑 上 下 文 映射 。 


E Dynp01_PLO1 View 
General | Edit\View: @ Context Properties © Context Mapping 
References Ove 
Comtex: 4 © Context | 
Methods Ja Per 
日 日 Event Handlers New 
Dynp01_PL Dynp01_PL j | 
A wae ái ca Actions | Edit Context Mapping... 
x = Plugs | Delete Context Mapping 
Miscellenecus Edit Model Binding... 
Delete Model Binding 


A] 3-182 JE Web Dynpro 项 目 效果 图 3-183 编辑 上 下 文 映 射 


3) 由 于 是 将 视图 控制 器 与 组 件 控 制 器 进行 映射 ， 因 此 在 弹出 的 窗口 中 选中 组 件 控制 
器 ， 并 单 击 “OK” 按 钮 ， 如 图 3-184 所 示 。 

4) 在 弹出 的 窗口 中 ， 就 可 以 看 到 组 件 控 制 器 的 上 下 文 ， 同 样 选 中 “Per” 结 点 (I 
图 3-185) ， 单 击 “Next” 按 钮 。 


Required Controllers 


ie Context Mapping 


Select required controllers: 


Select Context Element 


Elég Dynp01Comp - com.sap.demo.mydynp01.w 


E g Dynp01CompPlugWin - com.sap.demo.myd Select the context element you want to map 


| Dynp01Comp - com.sap.demo.my 


4 © Context 
4) Per 
B desc 
B id 


@ Ce oe 


图 3-184 选择 引用 的 对 象 图 3-185 选择 映射 的 结 点 
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5) 选中 需要 映射 的 特性 字段 ( 见 图 3-186) ， 单 击 “Finish” 按 钮 。 
6) 保存 之 后 ， 视 图 PLO1 的 上 下 文 映 射 也 已 经 完成 ， 如 图 3-187 所 示 。 


© Context Mappin 
Select the context elements to map 
Rename elements by clicking the corresponding item in the li 回 Dynp01_PLO1_View 
General Edit\View: @ Context Properties © Context Mapping 
4 HO Context References i orne 
v P 
ao a come a © Context 
M adese Methods A 
区 id 
vi Bic Event Handlers B desc 
TB name| 
Actions B id 
Plugs B name 
Miscellaneous 
3-186 ”选择 映射 的 特性 3-187 ”完成 映射 后 的 效果 


7) 在 本 开发 实例 中 ， 不 再 通过 消息 打印 来 进行 参数 的 判断 ， 所 以 需要 对 视图 添加 页 面 
的 UI 元 素 。 右 击 “Outline” 中 的 “RootElement” 元 素 , 在 弹出 的 快捷 菜单 中 选择 “Apply 
Template”， 如 图 3-188 所 示 。 

8) 在 弹出 的 窗口 中 选择 “Form” 表 单 形式 ， 单 击 “ Next” 按 钮 ， 如 图 3-189 所 示 。 


D @ Documentation View| 


Apply Template "7% 


RootElement| 
= ToDynp' 
Æ Context Me f 


Insert Child... Select Template 


Creates a form in the view 
Ctrl+X 


Ctrl+C 


Cut 


Copy 


Template Instance Name Form01| 


Paste Ctrl+V 
Replace With > Available Templates: | 
Delete Delete E Action Button Creates a form in the view | 
Move Up 国 Form 

=| Table 


Move Down 


Parameter Mapping 
Translatable Texts 


Apply Template 


Binding Chain | 


Expand All 
Show Help 


Bie Finish Cancel 


Properties Alt+Enter 
a 


图 3-188 选择 应 用 模板 图 


3-189 选择 模板 类 型 


9) 选择 表单 需要 绑 定 的 上 下 文 结 点 和 特性 ， 单 击 “Finish” 按 钮 ， 如 图 3-190 所 示 。 

10) 在 弹出 的 窗口 中 ， 对 字段 顺序 和 页 面 元 素 进行 配置 ， 单 击 “ Finish” 按 钮 ， 如 
图 3-191 所 示 。 在 这 个 窗口 中 ， 可 以 修改 页 面 UI 元 素 类 型 ， 如 使 用 文本 框 、 下 拉 列 表 或 单 
选 按钮 等 。 

11) 保存 之 后 ， 即 自动 生成 了 一 个 Web Dynpro 页 面 ， 如 图 3-192 所 示 。 

12) 使 用 相同 的 操作 和 配置 ， 对 Dynp01_PLO1_View 也 生成 对 应 的 表单 页 面 元 素 ， 如 
图 3-193 所 示 。 
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i. nll aa 


Apply Template 7 ~ 
p Specify Form View Properties 
Select Attributes 2 
Edit the properties of the form elements and their labels 
Select the attributes that the form elements will be bound to 
| Name Attribute Editor Bound Prop... 
4 国名 Context} ido id (Perid) fnputField Fares 
I ”回回 Per | | desc desc (Per.desc) Inputfield ie 
W] 可 desc ‖ | name name (Pername) nputfield value 
i VI g id | 
有 V| B name | 
Y F| o name I 
| || A default label text is set if there is no other type information available. 
I| In some special models, this could hide potential field label metadata at runtin 
V] Set default texts for all labels 
| | 
@ <Back | Next> |[ Einish | {Cancel ©) < Beck] New > | (Gfinishe—d)] [cance] 
| | 
E = 
veh ` - sm pel 一 y 
图 3-190 选择 对 应 上 下 文 图 3-191 修改 视图 元 素 类 型 
id: @id 
desc: @desc 
name: @name 


Al3-192 ”运行 效果 1 图 3-193 ”运行 效果 2 


13) 编译 、 部 署 、 运 行 (Dynp01Comp03App), 在 “id”“desc” 和 “name” 文 本 框 中 
输入 任意 内 容 ， 如 图 3-194 所 示 。 

14) 单 击 “ToDynp02CompView” 按钮 并 触发 页 面 跳 转 至 PLO 视图 ， 会 发 现 第 一 个 视 
图 填写 的 数据 成 功 传输 到 了 第 二 个 视图 ， 如 图 3-195 所 示 。 


ToDynp02CompView 
Er | 
id: 60089 id: 60089 
desc: 学 生 desc: FE 
name: IF name: IR 


图 3-194 运行 效果 网 3-195 
15) 下 面 再 验证 一 些 其 他 功能 。 切 换 到 组 件 控制 器 的 “Methods” 自 定义 方法 中 ， 新建 
一 个 modifyPer( ) 方 法 ， 如 图 3-196 所 示 。 
16) 输入 创建 的 自 定义 方法 的 名 称 ， 并 选择 对 应 的 方法 类 型 ， 如 图 3-197 所 示 。 由 于 
不 需要 额外 设置 方法 的 参数 ， 因 此 直接 单 击 “Finish” 按 钮 即 可 。 


Fi New TT > 


| Specify Method Properties 其 
Enter properties of Method ‘ 
< Component Controller = mere 
|| Return type 【ea | [Browse] 
Array Typ 
Dimension 


type filter text 


Event Handlers | 


i @ «Bock | Men» | Enish [cence 


BS 


3-197 输入 方法 名 称 


Al 3-196 
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17) 创建 方法 之 后 〈 见 图 3-198) ， 保 存 所 有 的 修改 。 
18) 双击 新 建 的 modifyPer 方法 ， 进 入 Java 编辑 器 页 面 ， 如 图 3-199 所 示 。 


& Component Controller 


«& Dynp01Comp 
General 225| } 
References [i] — il //00begin javadoc:modifyPer () 
- : /* 

Context 22° w 

type filter text LA 3 te 
Methods ——— 231 
Event Handlers medi/benavoid| 2328 (public void MESHE) í 

2 //@@begin modifyPer () 

Events 234 //@@end 


图 3-198 创建 方法 后 的 效果 图 3-199 方法 的 代码 编辑 
19) 在 自 定义 代码 域 添加 以 下 代码 ( 见 图 3-200): 


// get currentPerElement Reference 

IPerElement currentPerElement = wdContext. nodePer( ). currentPerElement( ) ; 
// modify attribute values 

currentPerElement. setId(" ID" ) ; 

currentPerElement. setDesc(" DESC" ) ; 

currentPerElement. setName('" NAME" ) ; 


public void modifyPer( ) { 
//@@begin modifyPer () 
7/ get currentPerElement Reference 
IPerElement currentPerElement = wdContext.nodePer().d 


// modify attribute values 
currbntPerElement.setId("ID"); 
currentPerElement.setDesc ("DESC"); 
currentPerElement . setName ("NAME"); 


图 3-200 添加 代码 


20) 切换 到 默认 视图 页 面 ， 在 按钮 的 方法 中 添加 方法 的 调用 ( 见 图 3-201): 


wdThis. wdGetDynp01CompController( ). modifyPer( ) ; 


public void onActionToDynp02CompView (com.sap.tc.webdynpro.pro 
{ 


//@@begin onActionToDynp02CompView (ServerEvent) 


wdThis.wdGetDynp0iCompController() .modifyPer (); 
wdThis.wdFirePlugOut (); 


//@@end 
} 


Al 3-201 添加 代码 


21) 保存 所 有 修改 之 后 ， 重 新 进行 编译 、 部 署 、 运 行 ， 运 行 效果 如 图 3-202 所 示 。 


图 3-202 ”运行 效果 
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3.4.5 接口 控制 器 


从 整个 组 件 的 架构 来 说 ， 接 口 控制 器 (Interface Controller) 是 整个 组 件 与 外 部 的 接 
口 ， 接 口 控制 器 中 定义 的 事件 、 方 法 都 是 可 以 被 外 部 组 件 访问 的 ， 当 然 在 组 件 控制 絮 中 
必须 实现 接口 控制 器 中 声明 的 这 些 对 象 。 通 常 意义 上 讲 ,， 会 通过 接口 控制 器 来 对 组 件 控 
制 器 进行 规范 化 ， 即 所 有 的 组 件 控制 器 在 公共 的 设计 基础 之 上 ， 遵 循 了 统一 的 设计 原则 
之 后 做 开发 。 

开发 实例 : 

1) 切换 到 组 件 模 型 编辑 器 中 ， 单 击 选中 接口 控制 器 ， 打 开 属 性 中 的 上 下 文 ， 如 
图 3-203 所 示 。 


图 Web Dynpro - [LocalDevelopment] mydynp01/Dynp01Comp - Web Dynpro Component Controller Editor - SAP NetWeaver Developer Studio /> E = a 
File Edit Navigate Search Project Editor Web Dynpro Run Window Help 
CE Se PE Mi 4D Hs SB PO-' ¥-O-Q~'OB6RV~ HrFUreeror eG 
(PL Web Dyn 52 N EP Search C| %5: Navigato | = O )f<Ẹ Dynpo1Comp 52 \ [J] Dynp01Comp,java | 加 Dynp03CompView _| JÌ) Dynp03CompViewjava a Sis) 
= eslglt ”| 1. (LocalDevelopment] mydynp01 SE © Palette > 
<j Components = la Select 
£ Dynp01Comp 
£% Component Controller ae 2 
[ Local Component Interface | View 
@ Inherited Interfaces | E Window 
器 Interface Controller 0% Custom 
FB Interface Views Controller 


$< Custom Controllers 


|  -~ | 
Sail rf k © Data Sources © 
@ Implemented Interfaces Dynp01Co da Dynp02co z 
国 Message Pool mpView Controller mpView RFC 
‘i a A 
@ Used Models AN = = Å Web Service 


«@ Used Components 


| Sue 
ae - 了 83 Java Bean 
£ Dynp01CompView aot m w | 
E Dynp02CompView Data Modeler | -一 一 一 一 
= A = = = 
Bw ee 区 Problems |) Properties £3) BB Snippets | [E] Infrastructure Console) 9) Error Log) Ë Tasks ide =) 
T Windows 


ef Dynp02Comp << Dynp01Compinterface 


(EE Outine £2 ~ @ Documentation View) li (vie @KContext Propertied © Context Mapping 
>» 回国 GSN © Property 
mam 


Al3-203 ”接口 控制 器 的 属 怕 


[a 


2) 添加 一 组 上 下 文 定义 。 这 里 添加 了 集合 属性 为 “1 .. 1” 的 与 流程 相关 的 “Process- 
Node” 绪 点 ， 结 点 中 包含 “ProcessId” 与 “ProcessName” 两 个 特性 ， 如 图 3-204 所 示 。 


[$i Problems 


N B Snippets Infrastructure Console | @) Error Log Å Tasks| 


< Dynp01Complinterface 


|General Edit\View: @ Context Properties © Context Mapping 
[ee | CF FE | Property Value 
Context a © Context Documentation 
Methods 4 0 ProcessNode Quick info 
Events 日 “processld Technical Documentatior 
B ProcessName Misc 


图 3-204 接口 控制 器 中 创建 上 下 文 


3) 保存 之 后 ， 组 件 控 制 器 已 经 报错 ， 报 错 消 息 会 提示 接口 中 的 上 下 文 定义 未 被 实现 。 
复制 “ProcessNode” 结 点 至 组 件 控 制 器 的 上 下 文中 ， 如 图 3-205 所 示 。 
按照 相同 的 操作 方法 分 别 定义 方法 和 事件 并 在 Java 编辑 器 中 实现 。 
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hy Problems i hd Snippets | [B] Infrastructure Console| 9] Error Log | A Tasks | 


“ Component Controller 
uw uw cl ep uu 
General || a © Context Documentation 
References | > 0 Per Quick info 
Context P [0° ProcessNode i Technical Documentatior 
ise 
Methods | Collection Cardinality 1.1 
Event Handlers | Initialize Lead Selection true 
Events | Input Element false 
| Name ProcessNode 
Selection Cardinality Oud 


图 3-205 组 件 控制 器 中 创建 上 下 文 


3.4.6 自 定 义 控 制 器 


Web Dynpro 中 除了 视图 控制 器 、 窗 口 控制 器 和 组 件 控 制 器 ， 在 Web Dynpro 工程 的 目录 
中 还 能 看 到 自 定 义 控制 器 (Custom Controller) 。 相 对 而 言 ， 视 图 控制 需 仅 用 于 界面 显示 以 及 
一 些 界面 属性 预 设 的 控制 ， 与 模型 的 数据 交互 完全 地 交 给 自 定义 控制 器 ， 这 样 才能 算 的 上 是 
一 个 好 的 MVC 设计 。 而 对 于 组 件 控制 器 来 说 ， 自 定义 控制 器 可 以 算是 同门 兄弟 ， 因 为 自 定 
义 控制 器 可 以 实现 组 件 控制 器 的 一 些 主要 功能 ， 每 当 创 建 一 个 自 定义 控制 器 ， 它 的 设计 模式 
也 与 上 一 节 中 提 到 的 组 件 控 制 咒 的 标准 类 相同 ;如 果 将 自 定义 控制 需 看 作 通 用 的 控制 器 ， 那 
么 组 件 控制 器 就 是 通用 控制 器 中 最 特殊 的 一 个 ， 如 图 3-206 所 示 。 


PL Web Dyn XN P Search | &5. Navigato| ”日 | 
eB) | 全 
4 © [LocalDevelopment] mydynp01 
4 yi Web Dynpro 
H Applications 
$ Models 
图 Component Interfaces 
4 4 Components 
4 喝 Dynp01Comp 
£ Component Controller 
> [A Local Component Interface 
4 $% Custom Controllers 


34 Dynp01Com.. B & 
Dynp01_PL Dynp01_PL Component = Dynp01Co 
01_View 02_View Controller mpInterf... 
© © @ 

$ 

©) MyCuscont Sg 
roller 
& 
2% MyCusController 

@ Implemented Interfaces 


图 Message Pool | 区 Problems (a Tasks (i Properties H Infrastructure Console] 
@, Used Models «< MyCusController 


m 


Data Modeler| 


Ea Used Components 


4 (Views E General -~ Overview 
= Outline 2 a Do View| 呈 日 References | Name: com.sap.demo.mydynp01.wd.comp.dynp01comp.MyCusController 
= Context 
图 图 | px | ~ Documentation: 
Methods | 


ins | Displays documentation details 


| Quick Information: 


Documentation: 


13-206 Ae PEI AE 


在 实际 的 项 目 实 施 过 程 中 ， 自 定义 控制 器 的 目的 是 用 于 对 Web Dynpro 模型 的 处 理 。 在 
Web Dynpro 中 使 用 自 定义 控制 器 还 有 以 下 两 个 好 处 : 一 方面 ，NWDS 提供 了 一 些 模板 向 导 
来 处 理 各 种 各 样 的 模型 ， 同 时 通过 向 导 能 够 自动 生成 自 定 义 控制 带 对 于 特定 模型 的 调用 方法 
及 具体 代码 ; 另 一 方面 ， 对 于 Web Dynpro 中 非常 复杂 的 逻辑 处 理 ， 可 以 通过 不 同 的 自 定义 
控制 器 进行 模块 化 管理 ， 也 有 利于 后 期 的 代码 维护 和 运 维 交 接 。 

比较 常见 的 3 种 Web Dynpro 工程 结构 如 下 。 

1) 视图 -窗口 -应 用 程序 : 最 精简 的 Web Dynpro 模型 ， 在 视图 中 定义 界面 ， 通 过 窗口 
关联 相应 的 应 用 程序 即 可 运行 ， 也 可 视图 控制 器 或 组 件 控制 絮 中 添加 代码 进行 逻辑 人 处理。 
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2) 模型 - 自 定义 控制 器 -视图 -窗口 -应 用 程序 : 需要 处 理 外 部 数据 源 时 ， 整 个 架构 
会 加 入 特定 的 自 定 义 控制 器 进行 逻辑 处 理 。 

3) 模型 ~- 自 定义 控制 器 -组 件 控制 锅 - 其 他 组 件 -视图 -窗口 -应 用 程序 .这 是 最 为 
复杂 的 Web Dynpro 程序 的 模型 。 


3.5 消息 池 


Web Dynpro 的 消息 池 可 以 提供 通用 的 消息 定义 ,方便 不 同 组 件 和 对 象 使 用 。 双 击 左 侧 
目录 中 的 “Message Pool”, 或 者 右 击 “Message Pool”， 在 弹出 的 快捷 菜单 中 选择 “Open 
Message Editor”， 即 可 打开 消息 编辑 器 视图 ， 对 想 要 显 示 在 屏幕 上 的 消息 进行 创建 和 编辑 ， 
如 图 3-207 所 示 。 

打开 消息 池 后 ， 在 右 侧 的 消息 编辑 带 中 ， 开 发 人 员 可 以 维护 对 应 的 消息 文本 、 消 息 类 型 
和 消息 键 。 消 息 文本 既 可 以 根据 需要 翻译 成 对 应 的 文本 ， 也 可 以 在 大 量 消息 内 容 定义 时 保持 
言 息 的 一 致 性 ; 开发 人 员 在 进行 源 代码 开发 时 ， 则 通过 消息 键 的 读 取 来 获取 对 应 的 消息 文 
本 。 最 终 程序 运行 时 会 根据 客户 端 运行 环境 进行 相应 的 消息 显示 ， 如 图 3-208 所 示 。 


Message Editor 


4 qj Dynp0IComp 
@ Component Controller 


Message Pool 


Create a new message 
Local Component Interface 


E Select checkbox to enable display of single apostrophes in Web Dynpro message in the output. 


#=-|FEB|P yp 


t $a Custom Controllers 


4 Implemented Interfaces 


A Me JA Key Type Text 
| Open Message Editor 
图 3-207 打开 消息 池 图 3-208 消息 编辑 器 


3.5.1 消息 类 型 


在 消息 编辑 器 中 ， 默 认 人 允许 定义 5 种 类 型 的 消息 : 信息 、 成 功 、 和 警告、 错误 和 文本 。 

前 4 种 类 型 的 消息 (信息 、 成 功 、 警 告 和 错误 ) 是 Web Dynpro 中 最 常用 的 消息 类 型， 
它们 都 会 以 提醒 消息 的 方式 出 现在 屏幕 上 ， 并 带 有 特定 的 图 标 (如 成 功 类 型 的 图 标 是 绿色 
勾 ， 错 误 消 息 类 型 则 是 红色 叉 ) ， 而 创建 这 3 种 类 型 消息 都 会 被 作为 IMessage < Component 
Name > 类 中 的 Java 常量 创建 。 要 注意 的 是 ，IWDMessageManager 的 实例 在 同一 个 组 件 中 始 
终 只 有 一 个 。 消 息 应 用 代码 如 下 : 


// 获 取 当 前 组 件 的 消息 管理 顺 实例 
IWDMessageManager msgMer = wdComponentAPI. getMessageManager( ) ; 
// 报 告 对 应 类 型 的 消息 

msgMer. reportWarning( " This is a yexWarning!" ) ; 


文本 类 型 的 消息 并 不 会 作为 Message < Component Name > 类 中 的 Java 常量 来 创建 ， 它 仅 
用 于 存放 视图 中 某 些 UI 元 素 的 属性 值 ， 如 标题 或 文本 框 等 。 在 控制 器 代码 编写 中 ， 文 本 类 
型 的 消息 可 以 通过 IWDTextAccessor 类 来 获取 ， 当 然 前 提 是 不 要 把 消息 主键 弄 错 。 获 取消 息 
文本 的 参考 代码 如 下 : 
90 


// 获 取 当 前 组 件 的 文本 获取 实例 

IWDTextAccessor txtAcc = wdComponentAPI. getTextAccessor( ) ; 
// 通 过 消息 键 获 取消 息 池 中 的 文本 信息 

String myTextMsg = txtAcc. getText(”< MessageKey > ) ; 


3.5.2 消息 区 域 


默认 情况 下 ， 当 提醒 消息 被 定义 时 ， 它 会 显示 在 页 面 的 下 方 。 接 触 过 视图 UI 元 素 的 开 
发 人 员 可 以 进一步 发 现 ， 其 实 消息 会 以 Web Dynpro 中 透明 表格 的 方式 出 现在 视图 的 最 下 方 。 
如 果 视 图 中 的 元 素 太 多 ， 或 者 页 面 过 长 ， 则 放 在 最 下 方 的 消息 很 容易 被 用 户 所 忽略 。 所 以 
Web Dynpro 提供 了 自 定 义 消息 区 域 位 置 的 UL 元 素 “Message Area”， 开 发 人 员 可 以 在 设计 视 
图 时 根据 实际 需要 对 消息 区 域 的 位 置 进行 个 性 化 设置 ， 如 图 3-209 所 示 。 


= — 
局 New Ul Element 有 So} 
Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 

[All] [all] FÍ MessageArea 
Action Active Components E MessageBasedTrigger 
Complex Adobe Q NavigationList 
Graphic Analytics BF Network | 
Integration Business Graphics E] OfficeControl 
Layout Business Intelligence E] PageHeader | 
Menu Calendar © PatternTabStrip 


图 3-209 消息 区 域 的 视图 元 素 


3.5.3 多 语言 配置 (I18N) 


SAP 通过 不 同 版 本 的 语言 配置 文件 来 实现 多 语言 功能 ， 同 时 ， 考 虑 到 后 期 维护 的 工作 
量 ，SAP 也 不 建议 开发 人 员 在 一 个 国际 化 的 程序 的 代码 中 编写 指定 语言 的 消息 代码 。 在 一 个 
Web Dynpro 工程 中 ， 多 语言 版 本 的 配置 不 需要 进行 额外 的 代码 编写 ， 普 通 业 务 人 员 或 最 终 
用 户 都 可 以 完成 ， 这 个 过 程 在 SAP 的 一 些 文档 中 被 称 为 “Internationalization”。 多 语言 配置 
的 优点 也 是 显而易见 的 : 不 再 需要 为 了 不 同 语言 版 本 而 准备 不 同 版 本 的 代码 。 

注 : 在 一 些 文档 中 “Internationalization” 被 简化 为 “Il18N”， 意 思 是 一 个 以 “TI” 开 头 、 
“N” 结尾 再 加 上 中 间 18 个 字母 的 单词 。 

在 Web Dynpro 中 ， 多 语言 的 配置 都 是 存放 在 扩展 名 为 .xl 的 描述 文件 中 。Web Dynpro 
的 元 素 与 描述 文件 的 对 应 关系 见 表 3-6。 


表 3-6 Web Dynpro 的 元 素 与 描述 文件 的 对 应 关系 


Web Dynpro 的 元 素 对 应 的 . xl 描述 文件 命名 
视图 (View) [NAME]. wdview. xlf; [ NAME ]. wdcontroller xlf 
窗口 (Window) [ NAME ]. wdwindow. xlf 
消息 池 ( MessagePool ) [ NAME ] MessagePool. wdmessagepool. xlf 
定义 类 型 (SimpleType ) [NAME]. dtsimpletype. xlf 


多 语言 配置 暂时 不 能 通过 类 似 创建 开发 工程 的 向 导 进 行 配置 操作 ， 具 体 过 程 如 下 : 
1) 通过 开发 工具 中 的 Navigator 或 者 文件 目录 的 查找 功能 ， 定 位 对 应 的 . xlf 描述 文件 。 
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BFE UREN | PROJECT |/src/package/[ PACKAGE ] -+-/[ PROJECT NAME ]/wd/comp/ *. xlf。 
2) 将 对 应 的 .xl 文件 复制 、 烙 贴 在 同一 目录 下 ， 并 根据 目标 语言 的 ISO 编码 重 命名 : 
如 需 翻 译 为 德语 ， 则 将 example. xlf 复制 、 粘 贴 在 同一 目录 后 ， 重 命名 为 example_de. xlf。 
部 分 常用 语言 编码 见 表 3-7。 

表 3-7 部 分 常用 语言 编码 


语 言 JSO 编码 语 言 JSO 编码 
英语 en 意大利 语 it 
德语 de 俄语 ru 
法 语 fr 日 语 jp 


3) 双击 从 NWDS 开发 工具 中 打开 重 命名 后 的 . xlf 描述 文件 ， 即 可 对 具体 的 文本 内 容 进 


行 翻译 配置 。 


4) 在 编译 之 后 新 的 . xlf 描述 文件 会 对 应 生成 一 个 以 . properties 为 扩展 名 的 配置 文件 ， 


供 程序 在 运行 时 调用 。 


以 example_de. xlf 为 例 ， 在 编译 后 会 生成 一 个 example_de. properties 的 文件 。 
需要 注意 的 是 ， 多 语言 配置 并 不 能 覆盖 Web Dynpro 工程 中 的 所 有 文字 ， 有 一 部 分 内 容 


是 在 开发 的 同时 已 指定 相应 语言 ， 且 无 法 通过 多 语言 配置 实现 翻译 内 容 的 展现 的 ， 具 体 包 括 
以 下 内 容 : 


1) UI 界面 元 素 中 的 输入 文本 和 提示 消息 文本 。 

2) 视图 控制 器 中 方法 、 动 作 的 描述 文本 。 

3) 窗口 (Window) 的 标题 。 

4) Java 字典 中 的 文本 内 容 和 描述 。 

开发 实例 : 

1) 新 建 Web Dynpro 工程 Dynp09， 创 建 一 个 组 件 和 视图 Dynp09_01Comp_01View， 任 意 


创建 一 些 UI 元素 ,视图 效果 如 图 3-210 所 示 。 


Personalinfo 


age: @age 
firstName: @firstName 
id: @id 

name: @name 


图 3-210 视图 效果 


2) 通过 Project Navigator 查找 该 View 对 应 的 .xlf 描述 文件 Dynp09 _ 01Comp _ 


01View. wdview. xlf, WKI 3-211 所 示 。 


3) 复制 该 描述 文件 并 粘贴 至 同一 目录 下 ， 重 命名 为 Dynp09_01Comp_01View. wdview_ 


de. xlf, WWE 3-212 所 示 。 
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-> dynp09_01 comp 
|=) Dynp09_01Comp_O1View. wdeontroller 


|=) Dynp09_O1Comp_O1View. wdview_de. properties 
@ Dynp09_O01Comp_O1View. wdview_de. xlf 


B Dynpt9 DlComp DlView. wdview. properties E Dror rok DLView. wdvier 


Al 3-211 定位 ， peen KI 3-212 创建 新 描述 文件 


i£: 截图 中 的 properties 文件 是 编译 后 生成 的 。 
4) 双击 新 命名 的 德语 文件 ， 从 NWDS 的 默认 编辑 器 打开 ， 单 击 下 方 的 “Resource Text” 
页 签 切换 至 页 面 元 素 和 文本 内 容 ， 如 图 3-213 所 示 。 


RootUIElementContai 
RootUIElementContai... labe] firstName 
RootUIElementContai... label id 


Delete 
RootUIElementContai... label name 


RootUIElementContai... caption PersonalInfo Set Filter 


Activate Filter 


器 


3-213 ”编辑 描述 文件 


5) 选中 “lable” 行 ， 单 击 “Edit” 按 钮 ， 即 可 在 对 应 文本 框 中 输入 相关 德语 描述 ， 如 
图 3-214 所 示 。 


Resource Type 


Resource name 


Text 


Maximum Length ess 


[ Translate 


器 


3-214 ”修改 对 应 文本 
6) 用 同样 的 方法 翻译 所 有 的 描述 并 保存 ， 如 图 3-215 所 示 。 
ee ee e 


RootWIElementCo... label 

RootUIElementCo... label 

RootUIElementCo... label Identifikation 
RootUIElementCo... label Hame 
RootUIElementCo... caption PersonalInfo 


BS 


3-215 ”修改 后 的 效果 


7) 保存 所 有 修改 ,重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 运 行 效 果 如 图 3-216 
所 示 。 


age: 
firstName: 


8) 浏览 絮语 言 设置 为 德语 ， 如 图 3-217 所 示 。 
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a EBW 
RER HED [acc] 


eA aI 
请 知 将 “www” 添 加 到 所 键入 Web 地 址 的 开头 


SETT C rliShiftHEn 时 应 添加 到 所 键入 Web 
BEEBE nes 


图 3-217 设置 浏览 器 语言 
9) 刷新 应 用 ， 页 面 自动 成 为 德语 版 ， 如 图 3-218 所 示 。 


Personalinfo 


Alter: 
Vorname: 
Identifikation: 
Name: 


Al3-218 运行 效果 


3.6 组 件 


介绍 过 了 Web Dynpro 中 的 三 大 件 〈 视 图 、 窗 口 、 控 制 器 ) ， 下 面 重新 介绍 一 下 Web 
Dynpro 的 组 件 (Component) 。 


3.6.1 组 件 的 生命 周期 


1. 运行 生命 周期 

由 于 组 件 直 接 对 应 Web Dynpro 的 应 用 程序 ， 并 通过 浏览 器 URL 进行 访问 ， 因 此 从 前 台 
访问 请 求 开始 到 对 应 服务 器 整个 会 话 实例 销毁 ， 即 称 为 组 件 的 一 个 生命 周期 。 组 件 控 制 器 作 
为 组 件 的 核心 控制 组 件 ， 其 生命 ;周期 们 随 着 整个 组 件 的 始终 ， 而 不 同类 型 的 窗口 视图 具有 不 
同 的 生命 周期 ， 但 其 生命 周期 都 包含 于 组 件 的 生命 周期 。 下 面 介 绍 组 件 中 各 个 对 象 的 生命 
周期 。 

1) 组 件 控制 器 : 组 件 控制 器 依赖 于 整个 组 件 应 用 ， 可 以 说 组 件 控 制 器 的 生命 周期 就 是 

整个 组 件 应 用 的 生命 周期 。 

2) 窗口 : 分 为 两 种 情况 ， 第 一 种 是 实现 了 接口 视图 的 窗口 ， 当 与 接口 视图 相关 的 应 
程序 被 访问 时 ， 窗 口 控制 器 的 生命 周期 开启 ， 此 时 与 组 件 控制 器 生命 周期 一 致 ， ， 
个 组 件 应 用 周期 (会 话 的 访问 周期 ); 第 二 种 是 没有 实现 接口 视图 的 窗口 (外 部 窗口 或 确认 
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窗口 )， 对 于 没有 实现 接口 视图 的 窗口 ， 则 是 通过 窗口 处 理 的 API 去 创建 或 销毁 窗口 实例 ， 
这 种 类 型 窗口 的 生命 周期 即 是 从 实例 创建 到 销毁 的 时 期 。 

3) 视图 : 视图 的 生命 周期 较为 短暂 ， 同 一 窗口 中 视图 的 切换 就 可 以 结束 一 个 视图 实例 ， 
视图 也 不 依赖 组 件 中 其 他 对 象 组 件 ， 但 在 组 件 的 生命 周期 中 ， 视 图 控制 器 通常 采用 与 组 件 控 
制 器 上 下 文 映 射 来 保持 数据 的 持久 性 。 

2. 逻辑 生命 周期 

组 件 在 不 同 的 生命 周期 时 间 点 会 执行 相应 的 操作 ， 以 控制 器 中 的 一 些 标准 方法 为 例 ， 
wdDolnit 方法 是 一 个 组 件 生 命 周期 的 开始 (初始 化 操作 ) ，wdDoExit 为 一 个 组 件 生命 周期 的 
结束 操作 〈 程 序 的 出 口 ) 。 下 面 针 对 几 种 控制 器 相对 整个 组 件 应 用 来 分 析 它 们 的 初始 化 执行 
顺序 。 

1) 组 件 控制 器 : 组 件 应 用 初始 化 时 ， 组 件 控 制 需 执行 wdDoInit( ) 方 法 ， 在 整个 组 件 的 
生命 周期 中 ， 它 只 执行 一 次 并 且 最 先 执行 。 

2) 窗口 控制 器 : 当 一 个 Web Dynpro 应 用 程序 被 访问 时 ， 实 现 了 默认 接口 视图 的 窗口 就 
会 被 初始 化 ， 并 执行 组 件 控制 器 当中 的 wdDolInit( ) 方 法 。 窗 口 控制 器 的 初始 化 动作 在 组 件 控 
制 器 之 后 执行 。 由 于 此 时 窗口 控制 器 的 生命 周期 与 组 件 一 致 ， 因 此 窗口 控制 器 的 初始 化 也 只 
执行 一 次 。 而 没有 实现 接口 视图 的 窗口 (一般 在 代码 中 实现 ) ， 它 的 初始 化 方法 会 随 着 整个 
窗口 实例 的 创建 与 销毁 反复 执行 。 

3) 视图 控制 器 : 视图 控制 器 的 生命 周期 在 整个 组 件 应 用 生命 周期 当中 ， 它 的 初始 化 也 
会 随 着 视图 实例 的 创建 与 销毁 反复 执行 。 

需要 强调 的 是 ， 在 不 同 场景 中 ， 可 能 需要 创建 多 个 控制 器 的 实例 ， 所 以 不 同 的 控制 器 可 
能 在 整个 组 件 应 用 实例 的 生命 周期 中 执行 多 次 ， 如 弹出 窗口 、 视 图 跳 转 等 都 是 控制 絮 生 命 周 
期 的 体现 。 在 这 个 操作 过 程 当 中 ， 窗 口 或 视图 实例 都 会 被 反复 创建 、 销 毁 ， 窗 口 或 视图 的 初 
始 化 也 会 执行 多 次 ， 但 对 于 同一 个 组 件 实例 来 说 ， 它 的 生命 周期 只 有 一 次 ,在 它 的 生命 周期 
当中 ， 初 始 化 操作 也 只 执行 一 次 。 


3.6.2 组 件 之 间 的 访问 


一 个 Web Dynpro 组 件 既 是 一 个 独立 的 开发 单元 ， 从 整个 项 目 来 看 也 是 一 个 可 被 复 用 单 
元 模块 ， 所 以 每 个 组 件 都 可 以 成 为 别 的 组 件 的 引用 或 是 引用 别 的 组 件 。 如 果 能 合理 有 效 地 对 
整个 开发 项 目 进行 规划 和 架构 ， 则 会 带 来 以 下 几 点 优势 ; 

1) 多 组 件 的 架构 反而 能 使 得 整个 项 目 更 易于 管理 和 后 期 维护 。 

2) 针对 基础 公共 功能 进行 统一 管理 和 开发 ， 节 约 开发 时 间 和 人 力 成 本 。 

3) 在 多 组 件 组 成 的 大 型 工程 中 ， 父 组 件 不 需要 了 解 子 组 件 的 数据 结构 、 处 理 逻 辑 等 内 
部 信息 ， 只 需要 关注 子 组 件 的 接口 即 可 ， 这 与 大 家 更 熟悉 的 “面向 对 象 ” 开 发 有 着 异 曲 同 
工 的 优势 。 

1.， 内 部 访问 

首先 要 说 明 的 是 ,“ 内 部 访问 ”并 不 是 说 组 件 内 部 访问 ， 而 是 只 涉及 视图 、 窗 口 和 组 件 
控制 器 之 间 的 引用 。 这 里 “内 部 访问 ”是 指 Web Dynpro 工程 内 部 多 个 组 件 之 间 的 访问 。 下 
面 通过 一 个 开发 实例 来 体验 一 下 。 
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开发 实例 : 


1) 在 Web Dynpro 的 子 日 录 中 ， 右 击 “Components” 组 件 ， 在 弹出 的 快捷 菜单 中 选择 
“Create Component”， 如 图 3-219 所 示 。 


2) 在 弹出 的 对 话 框 中 输入 组 件 的 名 称 “Dynp03Comp”， 并 选择 存放 的 目录 ， 下 方 默认 
已 选中 创建 默认 的 视图 和 窗口， 如 图 3-220 所 示 。 


届 New Component ~ = —_ 


Specify Component Properties 


Enter name and package for the new Web Dynpro Component 


Component Name Dynp03omp 


Component Package com.sap.demo.mydynp01.wd.comp.dynp03con | Browse: 


Choose additional capabilities for the new component 
4  [LocalDevelopment] mydynp01 7] Default Window and Views 
4 yi Web Dynpro 


Used Models 


Implemented Interfaces 


车 Applications 
> @ Models 


Component Interfaces 


| 
| 
4 a Components | 


> a Dyng 
Aa E Ctrl+V 
@ Dictionarie 
4 © Resources Apply Template 


Compare Metadata 


Development Component > 
> & Weel Remove from Context 


Ctrl+Alt+Shift+Down 


3-219 创建 组 从 


TF 


3-220 输入 组 件 名 称 


3) 由 于 选中 了 创建 自 定义 的 视图 和 窗口 ， 因 此 在 弹出 的 窗口 需 填写 自 定义 窗口 的 名 称 
以 及 对 应 的 接口 视图 名 称 ( 见 图 3-221) ， 完 成 后 单 击 “Finish” 按 钮 。 


4) 完成 后 记得 报错 所 作 的 修改 ， 右 击 新 建 的 视图 ， 在 弹出 的 对 话 框 中 选择 “Refactor” 
一 “Rename”， 对 视图 Dynp03Comp01View 进行 重 命名 ， 如 图 3-222 所 示 。 


= > —o— > | 
New Component - 


Specify Window Properties 


Enter the name for the default Window and Interface View. Specify new 
View(s) to embed into the Window. 


Window Name | Dynp03Comp01Win 


Interface View 


Interface View Dynp03CompinterfaceView 
yI 


=- >= = 
Rename View 7's re 
Create Start-Up Plug (for Application Reference) 
Embed Views 


Specify New Name 


Name 


Specify the new name for the View ‘'Dynp03CompView' 
Dynp03CompView 


New Name Dynp03Comp01View 


Finish 
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BS 


3-221 输入 窗口 和 视图 名 称 


3-222 输入 新 名 称 


5) 以 之 前 创建 的 “modigPer” 方 法 为 例 ,将 它 公开 给 Eok 
新 创建 的 组 件 进行 调用 。 不 论 是 方法 还 是 上 下 文 ， 如 果 需 要 | 二 

被 其 他 组 件 “ 发 现 ”"， 就 必须 通过 接口 控制 器 进行 公开 | tna 7E 
声明 。 — 


切换 到 已 经 完成 配置 的 组 件 Dynp01Comp， 复 制 组 件 控 iial | 
制 器 的 自 定 义 方 法 modifyPer( ) 到 接口 控制 器 中 ， 如 图 3-223 
图 3-223 “创建 自 定义 方法 
6) 回 到 Dynp01Comp 的 组 件 控制 器 中 ， 修 改 modifyPer( ) 实 现 ， 添加 消息 打印 代码 (W 
图 3-224): 


| type filter text á 


wdComponentAPI. getMessageManager( ). reportSuccess( currentPerElement. getId( ) ) ; 


public void modifyPer( ) { 
//@@begin modifyPer () 
// get currentPerElement Reference 
IPerElement currentPerElement = wdContext.nodePer().cur 


// modify attribute values 
currentPerElement.setId("ID"); 
currentPerElement.setDesc ("DESC"); 
currentPerElement.setName ("NAME"); 
wdComponentAPI.getMessageManager () .reportSuccess ( 


//@@end 


} 


图 3-224 添加 代码 


7) 至 此 完成 了 代码 的 准备 工作 ， 下 一 步 在 新 创建 的 Dynp03Comp 组 件 中 添加 引用 。 一 
种 方式 是 双击 打开 组 件 控制 器 ， 在 属性 的 “Reference” 引 用 子 标签 中 添加 子 组 件 ; 另 一 种 
方式 是 在 “Used Components” 使 用 的 组 件 中 直接 添加 。 

展开 Dynp03Comp, 47; “Used Components”， 在 弹出 的 快捷 菜单 中 选择 “Add Used 
Component”， 如 图 3-225 所 示 。 


4 <j Dynp03Comp | Dynp01Co 
{È Component Controller | mpView 


> Local Component Interface Et 
gx Custom Controllers | Data Modeler 
@ Implemented Interfaces A 


国 Message Pool | 区 Problems | E Properties z É 


@y Used Models | 


Add Used Component 


Compare Metadata 


Development Component 


Remove from Context Ctrl+Alt+Shift+Down 


图 3-225 添加 组 件 引 


ag 


8) 在 弹出 的 窗口 中 单 击 浏览 按钮 ， 选 择 “Dynp01Comp”， 如 图 3-226 所 示 。 
9) 输入 引用 组 件 的 名 称 “Dynp01Comp”， 这 里 可 以 理解 为 在 计算 机 操作 系统 中 创建 快 
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捷 方式 时 定义 的 快捷 方式 名 称 ， 单 击 “Finish” 按 钮 ， 如 图 3-227 所 示 。 


New Web Dynpro Component Usage 


Specify Web Dynpro Component Usage Properties 


Enter a new name and choose the component used a 


J Choose Web Dynpro Component 


Select a Web Dynpro component or component interface definition 


(<=) Dynp01Comp - com.sap.demo.mydynp01.wd.comp.dynp01comp} 
ej Dynp02Comp - com.sap.demo.mydynp01.wd.comp.dynp02comp 


<j Dynp03Comp - com.sap.demo.mydynp01.wd.comp.dynp03comp 


- 一 一 =- 
帮 New Web Dynpro ‘Component Usage lied 


Specify Web Dynpro Component Usage Properties 


Enter a new name and choose the component used i? 


Name Dynp01Comp 


Used Web Dynpro Component com.sap.demo.mydynp01.wd.comp.dyn | Browse: 
Lifecycle -| 


到 3-226 ”选择 组 件 


图 3-227 输入 引用 组 件 名称 


10) 完成 后 保存 所 有 修改 ， 此 时 在 “Dynp03Comp” 组 件 (以 下 简称 03 组件) 的 模型 
编辑 器 里 已 经 能 看 到 成 功 添加 了 原 “Dynp01Comp” 组 件 (以 下 简称 01 组件) 的 接口 控制 


器 ， 如 图 3-228 所 示 。 


11) 单 击 “Data Link” 按 钮 〈( 见 图 3-229) ， 单 击 03 组 件 的 组 件 控制 器 并 拖 电 至 01 组 
件 的 接口 控制 器 ， 完 成 对 其 的 引用 。 


[E Dynp03Comp01View 


# [LocalDevelopment] mydynp01 


喝 Dynp03Comp 


4-4 Dynp03Com... 


Al 3-228 添加 后 的 效果 


© pra 
Component 
Controller 
& 
© © 


图 3-229 添加 数据 链接 


12) 在 弹出 的 窗口 中 可 以 进行 组 件 之 间 的 上 下 文 映 射 ， 左 侧 是 03 父 组 件 ， 右 侧 是 被 引 
用 的 01 子 组 件 ， 如 图 3-230 所 示 。 由 于 本 实例 不 需要 进行 映射 配置 ， 因 此 直接 单 击 “ Fin- 
ish” 按 钮 即 可 。 


13) 在 03 组 件 的 组 件 控制 器 定位 到 wdDolInit( ) 方 法 并 添加 01 组 件 的 自 定义 方法 ， 添 加 
以 下 代码 ( 见 图 3-231): 


wdThis. wdGetDynp01CompInterface( ). modifyPer( ) ; 
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Context Mapping 


Select the context elements to map 


Drag from right to left to create and map a new element in the left tree. 
Drag from left to right to map an existing element. 


Dynp03Comp Dynp01CompInterface (via 


© Context 
器 ProcessNode 


3-230 ”编辑 上 下 文 映射 


public void wdDoInit() 
{ 
//@@begin wdDoInit () 
wdThis.wdGetDynp0iCompInterface() .modifyPer(); 
//@@end 


图 3-231 添加 代码 


He 


14) 创建 一 个 以 03 组 件 为 默认 界面 的 应 用 程序 。 右 击 “Application”， 在 弹出 的 快捷 菜 
单 中 选择 “Create Application” 如 图 3-232 所 示 。 


4 & [LocalDevelopment] mydynp01 < 177 //@@begin j 


1788 /** 
4 Web Dynpro. 
jg so | 79 * Declared| 


a Z Applicat: 
= Pp Create Application 


Paste Ctrl+V 


Compare Metadata 
Development Component 


» Remove from Context Ctrl+Alt+Shift+Down 


图 3-232 创建 应 用 
15) 输入 应 用 程序 名 称 ， 选 择 03 组 件 及 其 接口 视图 ， 如 图 3-233 所 示 。 
TE New Application DT 


Select References 


Select References for the Application 


Web Dynpro Componer [Dynp03Comp - com.sap.demo.mydynp01.wd.comp.dynp03comp Ag 
Interface View | Dynp03CompinterfaceView 


Startup Plug Default 


Ly 


3-233 ”选择 接口 视图 


16) 保存 所 有 修改 后 ， 编 译 、 运 行 该 应 
用 程序 ， 即 可 看 到 03 组 件 调 用 01 组 件 方法 i| Execete Component Controlar wahaini] 
成 功 ， 如 图 3-234 所 示 。 


Ly 
w 
1 
N 
U 
E 
Di 
my 
QI 
sak 
No 
7 也 
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2. 外 部 访问 

从 Web Dynpro 工程 的 外 部 来 看 ， 或 者 从 SAP 的 Java 服务 器 的 角度 来 看 ， 每 一 个 工程 其 
实 都 是 一 个 开发 组 件 (Development Component, DC), SAP 建议 SAP 的 开发 实施 工程 都 以 
DC 的 形式 进行 ， 并 存放 在 对 应 的 开发 架构 中 。 对 于 默认 的 Web Dynpro 工程 ， 其 实 之 前 的 开 
发 实例 都 是 存放 在 了 一 个 本 地 的 开发 组 件 中 ， 如 图 3-235 所 示 。 


Eam) 


Select Software Component 


Select the software component where you want to create the DC(s). 
The settings for the selected component will be refreshed first. 


a & LocalDevelopment 
(g MyComponents [demo.sap.com] | 
| Finish | (ceneel 


图 3-235 ”本 地 开发 组 件 


如 果 需 要 进行 多 个 开发 人 员 的 协同 开发 ， 则 所 有 相关 的 开发 工程 都 需要 上 传 至 服务 器 端 
的 开发 架构 进行 版 本 同步 和 管理 ， 并 且 SAP 的 开发 组 件 支持 许多 不 同类 型 的 开发 工程 ， 如 
图 3-236 所 示 。 


= — pn GREA 
B New Development Component (Project) a ai ba = 
New Development Component 
Select Development Component Type. 
H Type: 


4 | B® sap.com 


E Composite Application 
> Content 
f b DC Build 
加 Dictionary 
> WP Enterprise Portal 
#) External Library 
j @ Java 
> @ Java EE 
DD Process Composer 
Ry Rules Composer 
QË Service Composer 
Service Group Configuration 
> 3 Software Logistics 


wi Text | 
| E] Visual Composer 
yA Web Dynpro 
Supported DC Type 
[ <Back | Next> | [ Finish | (meneel 


图 3-236 开发 组 件 的 不 同类 型 
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不 论 是 什么 类 型 的 开发 组 件 ， 都 包含 了 所 有 类 型 的 开发 对 象 (类 、 接 口 及 表 结 构 等 内 
容 ) ， 同 时 它 有 一 个 统一 的 对 外 接口 ， 叫 作 开 发 对 象 的 “Public Part” (公共 部 分 ，PP) 。 以 
之 前 的 Web Dynpro 工程 为 例 ， 在 需要 编译 时 ， 除 了 右 击 工程 名 出 现 的 “Rebuild”， 还 可 以 
选择 “Development Component” 一 “Build” 进 行 编译 。 如 果 工 程 涉及 外 部 访问 ， 则 必须 使 
用 第 二 种 操作 进行 编译 ， 即 必须 以 开发 组 件 进行 编译 ， 这 个 编译 过 程 会 将 每 个 公共 部 分 编译 
成 为 一 个 独立 的 JAR 文件 。 因 此 如 果 不 是 通过 开发 组 件 的 编译 进行 操作 ， 则 公共 部 分 的 内 
容 就 无 法 更 新 ， 工 程 也 就 无 法 被 外 部 访问 。 

在 项 目的 架构 和 设计 中 ， 经 常会 抽象 出 诸多 基础 功能 ， 这 些 基 础 功能 会 根据 涉及 内 容 不 
同 而 最 终 落 脚 为 几 个 基础 功能 开发 组 件 ， 其 他 开发 组 件 通 过 对 基础 功能 DC 的 依赖 、 引 用 ， 
去 调用 基础 部 分 的 功能 ， 如 审批 意见 、 附 件 管理 、 日 志 记录 或 数据 库 连 接 等 。 

开发 实例 : 

1) 在 本 实例 中 ,假设 mydynp01 工程 为 基础 功能 ， 则 需要 新 建 另 一 个 Web Dynpro 工程 
对 其 进行 访问 和 调用 。 在 空白 处 右 击 或 单 击 开发 工具 中 左上 角 。“ 新 建 ”按钮 ， 选 择 新 建 
Web Dynpro 开发 组 件 ， 如 图 3-237 所 示 。 


并 [LocalDevelopment] mydynp01 | 


> || 5: Web Dynpro Development Component 


Fi Others.. 


图 3-237 创建 Web Dynpro 开发 组 件 


2) 选择 本 地 开发 (后续 章 节 会 有 服务 端 同步 开发 实例 )， 单 击 “ Next” 按 钮 ， 如 
图 3-238 所 示 。 

3) 输入 自 定义 Web Dynpro 开发 组 件 名 称 和 其 他 必要 信息 ( 见 图 3-239)， 单 击 “Next” 
按钮 。 


[a New Development Component (Project) = 
New Development Component | 
Create New Development Component (Project) E | 
Vendor: demo.sap.com 
ji -= EO” 
FB New Development Component (Project) l | Name: fmydynpo2 | 
Select Software Component Caption: mydynp02 

Select the software component where you want to create - - 

the DC(s). The settings for the selected component will be Language: | American English 
Domain: | Basis 
Support Component 

(For Example BC-DWB-FOO) 
P DCL for Now Add to Sou l 


图 3-238 选择 本 地 组 件 图 3-239 输入 项 目 信息 


4) 完成 工程 创建 后 ， 右 击 “Components” 组 件 ， 在 弹出 的 快捷 菜单 中 选择 “ 
Component” 如 图 3-240 所 示 。 


5) 按照 之 前 的 步 双 ,创建 “Dynp02_01Comp” 组 件 ， 并 默认 创建 “Dynp02_01Comp_ 
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Create 


01Win” 窗 口 和 “Dynp02_01Comp_01View” 视 图 ， 如 图 3-241 所 示 。 


4 [SS [LocalDevelopment] mydynp02 
4 yi Web Dynpro 
& Applications 
$ Models 
Component Interfaces 
4 «&) Components 


4 < Dynp02_01Comp 
2 Component Controller 


4 Local Component Interface 
® Inherited Interfaces 
2È Interface Controller 
> §& Interface Views 
$% Custom Controllers 
@ Implemented Interfaces 


4 这 [LocalDevelopment] mydynp02 国 Message Pool 
4 yi Web Dynpro @y, Used Models 
Ha Applications «i Used Components 


4 Models 4 E Views 
Component Interfaces (E Dynp02_01Comp_01View) 
一 一 一 一 一 一 一 一 4 window 


| 四 Components | 
> @ Diction Create Component 


T] Dynp02 01Comp_01Win 


> @ Dictionaries 
> & Resour Paste > @ Resources 


器 


3-240 “创建 组 件 图 3-241 创建 后 的 效果 


6) 通过 切换 按钮 ， 切 换 到 “Development Infrastructure”， 如 图 3-242 所 示 。 
7) 在 左 侧 列表 中 找到 “MyCOmponents” 即 可 看 到 我 们 创建 的 Web Dynpro 项 目 ， 如 
图 3-243 所 示 。 


FEY R Process De... G bat 
加 Composite Application 


| {| Composite Designer 

H$ Debug 

|| dt? Design Time Repository 

‘34 Development Infrastructure 

TR Process Development 

3 ‘ 78 

E] Visual Composer 
> 
> 


MyComponents [demo.sap.com] 
“Dn mydynp01 | 
ya mydynp02 


Other... 


Al 3-242 切换 透视 图 图 3-243 MAME 


注 : 工程 图 标 左上 角 的 雪花 表示 最 新 的 修改 
还 未 以 开发 组 件 形式 编译 ， 编 译 后 雪花 标识 就 会 
消失 。 

8) 定义 mydynp01 的 PP， 选中 01 工程 , 单 


*Da MydyNpO1 


Overview | Dependencies 


Defined Public Parts 
XK 了 p “ ” 
击 A H 部 分 页 签 , 单 击 Add 按 gi ’ 如 Specify the list of public parts forthis DC 


图 3-244 所 示 。 
9) 在 弹出 的 窗口 中 输入 自 定义 公共 部 分 名 


称 ， 单 击 “Finish” 按 钮 ， 如 图 3-245 所 示 。 图 3-244 ”公共 部 分 


[还 
HT 


Hl 
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10) 将 公开 的 部 分 添加 至 公共 部 分 ， 右 击 “api”， 在 弹出 的 快捷 菜单 中 选择 “Manage 


Entities”， 如 图 3-246 所 示 。 


[New Pi or = 


Public Part 


Enter the public part name and select a purpose. You can also enter a caption and description. S% 


= 
由 


Purpose: COMPILATION ~ 


Caption: 


Description: 


KI 3-245 输入 公共 部 分 名 称 


| Open Activities 


*i MydyNpO1 
[Overview | Dependencies | Public Parts | Child DCs | Pe: 


Defined Public Parts 
Specify the list of public parts for this DC 

CES 
X Delete 


Reference Entities 


Refresh Children 


3-246 管理 实体 的 菜单 选择 


11) 在 弹出 的 窗口 中 选择 Dynp01Comp ， 单 击 “Finish” 按 钮 ， 完 成 公共 部 分 配置 ， 如 


图 3-247 所 示 。 


FE Menage Entities EEO ee aE E 
| 


Entity Administration of Public Part 'api' 


Add and remove entities by using the checkboxes. Configure entities by selecting one or more of them 


Entities: 


Java Class 


Java Package 


Java Package Tree 
File 

Folder 

Folder Tree 


Dictionary Simple Type 


Dictionary Structure 


v 
可 回回 回回 回回 回国 


inp ® fL2Pewees 


Web Dynpro Component 
ef Dynp03Comp (com.sap.demo.mydynp01.wi 
of) Dynp02Comp (com.sap.demo.mydynp01.w/ 


| Dynp01Comp (com.sap.demo.mydynp01, 


> [E & Common Model 


Name: Dynp01Comp 


Subtype: 


Descriptive Properties 
Caption: 


v 


Source 


Description: 


com.sap.demo.mydynp01.wd.comp.dynp01cor 


com.sap.demo.mydynp01.wd.comp.dynp01cor 


Ly 


3-247 ”选择 添加 内 容 


12) 保存 修改 后 ， 新 建 的 公共 部 分 中 已 包含 Dynp01Comp 组 件 ， 如 图 3-248 所 示 。 
13) 接 下 来 添加 新 建 的 开发 组 件 mydynp02 对 mydynp01 的 依赖 ， 如 图 3-249 所 示 。 
选中 mydynp02 后 ， 打 开 “Dependencies” 依 赖 页 签 ， 单 击 “Add” 按 钮 。 
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E3 Component Properties 33 Open Activities | 
(E3 Component Properties 53 [a] Open Activities | *Sa mydynp02 


Da mydynp01 Overview [Dependencies |Public Parts | Child pcs| Permi 


Overview | Dependencies | Public Parts| Child DCs| Permis: Required DCs 
Specify the list of DCs required for this DC 
》 D te/aii/base/offline/facade 


Defined Public Parts 


Specify the list of public parts for this DC 


x > Ba tc/bl/exception/lib 
5 inl > Ba te/bl/logging/api 
| Dynp01Comp| > Da tc/cmi 
》 Spq tc/ddic/runtime/facade 
bp Ba tc/wd/api 


图 3-248 添加 后 的 效果 图 3-249 ”依赖 属性 


14) 在 弹出 的 窗口 中 找到 mydynp01 并 选中 ， 单 击 “Next” 按 钮 ， 如 图 3-250 所 示 。 
oe 0 ei 


Choose DCs to be referenced 
| 


Type text to filter (*=any string, ?=any character) 


| F] g& MMR_SERVER [sap.com] E) | 
| > [© 8 MOIN_BUILDT [sap.com] | 
4 E g4_MyComponents [demo.sap.com] 


©] 8 SAP_BUILOT [sap.com] 
回 BË SAP_XIAF [sap.com] 

F| B SERVERCORE [sap.com] 
> E B& SERVICE-COMP [sap.com] 
国 
= 
A 


= = 


B VCFRAMEWORK [sap.com] 
BÊ VCFREESTYLEKIT [sap.com] 
RË VOICEVC [sap.com] 


四 | 


@ [ER ea) (cee 


图 3-250 选择 对 应 开发 组 件 
15) 根据 实施 需求 对 依赖 明细 进行 配置 ， 单 击 “Finish” 按 钮 ， 如 图 3-251 所 示 。 


F Add Dependencies el 


Configure Dependencies 
|| Configure details of new dependencies g 
f 
New Required DCs: Dependency Details: 
| + "in myyn E] Design Time | 
| = | 


strong ad 


| © < Back Next > Cancel | 


Ly 


3-251 选择 依赖 方式 


104 


至 此 已 完成 所 有 开发 组 件 的 配置 ， 记 得 保存 所 做 修改 并 以 开发 组 件 方式 编译 。 

16) 切换 回 到 Web Dynpro 透视 图 ， 在 “mydynp02” 中 添加 对 “mydynp01” 组 件 的 引用 
( 见 图 3-252) ， 右 击 “Used Components”， 在 弹出 的 快捷 菜单 中 选择 “Add Used Compo- 
nent”， 在 弹出 的 浏览 窗口 中 新 增 了 “Dynp01Comp” 组 件 ， 即 为 新 添加 依赖 “mydynp01” 
的 公共 部 分 “api” 内 容 ， 选 中 该 组 件 即 可 。 

17) 双击 “Dynp02” 项 目的 组 件 控制 器 ， 进 入 模型 编辑 器 ， 通 过 数据 链接 的 连 线 ， 创 
建 组 件 控制 器 到 “Dynp01Comp” 接 口 控制 器 的 关联 ， 如 图 3-253 所 示 。 


New Web Dynpro Component Usage L 回 | _%8 
Specify Web Dynpro Component Usage Properties 
Enter a new name and choose the component used 


Choose Web Dynpro Component 


|| Select a Web Dynpro component or component interface definition 


[4 Dynp01Comp - com.sap.demo.mydynp01.wd.comp.dynp01comp 


af] Dynp02_01Comp - ‘com.sap.demo.mydynp02.wd.comp.dynp02_01co| 


Nm 


$ 
Mp Dynp02_01 
T  compint... 


图 3-252 ”添加 组 件 引 用 图 3-253 ”添加 后 的 效果 
18) 在 “Dynp02” 组 件 的 组 件 控制 器 定位 到 “wdDomit( )” 方 法 ， 并 添加 以 下 代码 
( ILEI 3-254) : 


F i 
$ 
Component D 
Controller P 
& 


wdThis. wdGetDynp01CompInterface( ). modifyPer( ) ; 


public void wdDoInit() 
{ 
//@@begin wdDoInit () 
wdThis.wdGetDynp0iCompinterface() .modifyPer(); 
//@@end 
} 


图 3-254 添加 代码 
19) 创建 一 个 以 “Dynp02” 组 件 为 默认 界面 的 应 用 程序 ， 并 部 署 运行 ， 运 行 效果 如 图 3-255 


所 示 。 


[Co 


图 3-255 运行 效果 


3.7 模型 


Web Dynpro 模型 为 应 用 程序 可 以 访问 不 同类 型 的 数据 源 (如 RFC, WebService 或 EJB) 
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提供 了 标准 的 接口 ， 换 句 话 说 ，Web Dynpro 通过 创建 模型 的 形式 自动 生成 了 规范 化 的 客户 
端 代理 类 ， 开 发 人 员 只 需要 对 代理 类 做 操作 便 可 以 快速 完成 对 接口 的 调用 。 


3.7.1 WMG AES 


1. 自 定义 控制 器 在 使 用 模型 过 程 中 起 到 的 作用 

组 件 控制 器 其 实 是 最 特殊 的 一 个 自 定 义 控制 器 ， 而 一 般 的 自 定义 控制 器 并 不 作为 全 局 的 
控制 与 中 转 器 ， 而 是 更 多 关系 到 后 台 服 务 ， 开 发 工具 提供 模型 导入 的 向 导 并 将 模型 结构 转化 
为 本 地 可 识别 的 代理 类 ， 自 定义 控制 器 可 以 进一步 地 将 模型 的 数据 结构 定义 到 上 下 文中 ， 同 
时 初始 化 接口 结构 数据 并 生成 了 调用 接口 的 方法 。 换 言 之 ， 通 过 配置 生成 的 自 定 义 控 制 需 
中 ， 它 的 上 下 文 包含 了 接口 的 输入 /输出 参数 ， 它 的 控制 器 (类 文件 ) 中 包含 调用 接口 的 方 
法 ， 对 上 下 文 输入 结构 赋值 ， 执 行 接口 方法 ， 最 后 通过 上 下 文中 的 输出 结构 获取 接口 返回 
数据 。 

2. 规范 化 地 管理 自 定义 控制 器 

事实 上 ， 自 定义 控制 器 与 模型 可 以 是 多 对 多 的 关系 ， 一 个 目 定 义 控制 絮 可 以 通过 应 用 模 
板 的 方式 (Apply Template) 引用 多 个 模型 ， 同 时 一 个 模型 根据 接口 方法 的 不 同 又 可 以 创建 
多 个 自 定义 控制 器 ， 理 论 上 这 几 种 映射 关联 的 方式 都 是 可 行 的 ， 但 从 开发 设计 的 角度 来 说 ， 
尤其 是 考虑 到 良好 的 重用 性 与 后 期 的 维护 ， 这 样 做 并 不 符合 规范 。 严 格 地 来 讲 ， 一 个 自 定义 
控制 器 对 应 一 个 模型 ， 当 模型 中 含有 较 多 的 接口 方法 时 ， 比 如 WebService PAA FIAT 
法 ， 那 么 自 定 义 控制 絮 中 就 含有 多 个 接口 调用 方法 ; 当 模型 中 只 含有 一 个 方法 时 ， 自 定义 控 
制 絮 就 对 应 只 有 一 个 接口 方法 以 及 方法 对 应 的 输入 /输出 结构 ， 如 图 3-256 所 示 。 这 样 做 ， 
如 果 接 口 结构 变 ， 不 会 影响 到 其 他 接口 ， 同 时 项 目 开发 或 后 期 维护 都 比较 清晰 ， 便 于 修改 。 


Dynp03Co 
mpView 
of 


es Ss 5 Dynp03Co 
mpInterf... 
~~ 


FindPersMo 
delContr... 
& 


& 


Dynp03Co Dynp03Co 
mplView mp0lView 
& & 


Component 
Controller 


s 
TelModelCo 
ntroller 


a TelModel 


og 
MalModelc 
ontroller 
ay 


avalmoda 


@4FindPersMo 
dd 


图 3-256 Ae CPS tl ae Be 
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3. 模型 与 组 件 控制 器 的 关系 

组 件 控制 器 在 组 件 中 起 控制 与 中 转 的 作用 ， 视 图 与 视图 之 间 、 视 图 与 其 他 控制 器 之 间 的 
数据 传递 都 是 通过 组 件 控 制 器 进行 ， 同 样 前 台 的 UI 在 访问 后 台 服 务 时 也 是 通过 组 件 控制 器 
中 的 上 下 文 进行 传递 。 

控制 句 与 控制 器 之 间 的 数据 传递 与 调用 并 不 是 都 要 经 过 组 件 控 制 器 ， 实 际 上 Web Dyn- 
pro 在 设计 时 并 没有 做 这 方面 的 硬性 限制 ， 但 从 系统 设计 的 角度 ， 以 及 从 代码 的 重用 与 可 维 
护 性 上 来 讲 ， 需 要 遵循 这 样 一 种 模式 ， 即 在 本 章 最 开始 介绍 的 MVC 模式 。 当 把 所 有 的 应 用 
逻辑 都 封装 在 组 件 控 制 器 中 ， 把 基本 的 数据 定义 在 上 下 文 结构 中 时 ， 就 能 体会 到 代码 维护 一 
致 性 的 便利 。 

一 般 情 况 下 ， 开 发 人 员 都 会 遵循 这 样 一 个 流程 : 视图 首先 调用 组 件 控 制 器 中 的 方法 ， 组 
件 控制 絮 引 用 自 定义 控制 器 并 调用 自 定 义 控制 絮 中 与 模型 映射 产生 的 方法 ， 最 后 自 定义 控制 
器 通过 调用 系统 自动 生成 的 模型 客户 端 代理 类 来 调用 后 台 接 口 ， 同 样 视 图 、 组 件 控制 希 和 自 
定义 控制 器 之 间 都 可 以 通过 上 下 文 映 射 的 方式 实现 数据 的 共享 。 在 共享 过 程 中 ， 自 定义 控制 
器 作为 源 结 点 ， 视 图 通过 上 下 文中 的 输入 参数 为 接口 赋值 ， 通 过 上 下 文中 的 输出 参数 获取 接 
口 的 返回 数据 ， 如 图 3-257 所 示 。 


R| P 


A 
Dynp03Co 


ls = 
mpInterf... 
of of 
MalModalC FindPersMo 
ontroller delContr... 
& & 


@yFindPersMo 
da 


图 3-257 自 定 义 控 制 右 与 组 件 控制 右 


3.7.2 RFC 模型 


RFC (Remote Function Call ， 远 程 功 能 调用 ) 是 SAP 为 了 提供 其 他 系统 可 以 调用 ABAP 
功能 而 提供 的 一 种 技术 ,是 SAP ERP 与 其 他 系统 (包括 SAP 系统 或 非 SAP 系统 ) 间 的 一 种 
双向 接口 技术 ， 也 是 SAP 与 外 部 通信 的 基本 协议 。RFC 是 基于 是 CPI -C ( Common Program- 
ming Interface for Communications layer) 实现 的 ， 在 最 初 RFC 创建 时 ， 只 能 被 C 语言 的 程序 
调用 ， 后 来 为 了 适应 网 络 时 代 的 变化 ， 也 人 允许 Java 语言 进行 访问 ， 而 在 Web Dynpro 中 RFC 
自然 也 允许 其 通过 企业 连接 器 进行 访问 。 
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简单 来 说 RFC 的 作用 是 系统 调用 当前 系统 外 的 程序 模块 ， 从 而 实现 某 个 功能 ， 但 两 个 
系统 中 至 少 有 一 个 必须 是 基于 ABAP 应 用 服务 器 的 系统 。 当 然 RFC 也 可 以 在 ERP 系统 内 被 
本 系统 的 程序 调用 ， 而 通常 情况 下 都 是 为 跨 系 统 调 用 而 使 用 的 。 

REC 的 功能 包含 以 下 几 点 : 

e 登录 并 退出 远程 ABAP 系统 (在 Web Dynpro 配置 中 ， 导 入 模型 使 用 的 ABAP 系统 配 

置 不 必 与 实际 运行 时 的 ABAP 系统 保持 一 致 ) ， 并 进行 权限 检查 。 

e 调用 并 管理 远程 系统 会 话 所 需 的 通信 线程 。 

© 自动 将 功能 模块 中 的 参数 转换 成 远程 系统 所 需 的 格式 ， 或 反之 将 远程 系统 需要 的 格式 

转换 为 SAP 中 的 参数 。 其 中 可 能 包含 不 同 技术 平台 之 间 的 转换 。 

e 处 理 通信 过 程 中 的 错误 ， 如 果 需 要 ， 也 可 返回 报错 明细 给 调用 方 。 

e 可 以 对 外 声明 ， 负 责 远程 调试 的 实现 。 

TE SAP ABAP 系统 中 (包括 R/3 BR ECC, BW, PI 
系统 ) ， 登 录用 户 都 可 以 在 权限 允许 的 前 提 下 通过 SE37 
事务 代码 进行 功能 模块 的 创建 和 修改 ， 而 只 有 在 属性 中 
将 功能 模块 的 类 型 选择 为 “Remote - enabled module” 7 


| Processing Type 


ONormal Function Module 
@)Remote-Enabled Module 
Update Module 


能 被 外 部 系统 调用 ， 有 时 非 ABAP 开发 人 员 会 一 直 无 法 搜 ©Start immed. 
索 到 对 应 的 RFC 名 称 ， 很 有 可 能 就 是 因为 没有 修改 它 的 Olmmediate Start, No Restart 


O Start Delayed 


属性 导致 的 ， 如 图 3-258 所 示 。 

以 下 以 测试 系统 中 的 ZTEF_001 功能 模块 为 例 进行 简 
单 介绍 ， 登 录 ECC 系统 后 ， 输 入 事务 代码 “SE37”， 随 图 3-258 RFC 的 关键 属性 
后 输入 函数 名 称 并 单 击 “Display” 按 钮 ， 如 图 3-259 所 示 。 


Function Builder: Display ZTEF_001 
tt PIGO 2:4 ABO AS 
Function module ITER 001 Active 
aac Atrutes AER Opert C angna. C Tables lL Giceptions C Source code 


CO 〇 colrun 


CEJ Tyee SATE pe B Poe EXE 
I NANE TYPE NANE T iLi 


BI 3-259 RFC 中 定义 的 字段 
每 个 功能 模块 都 包含 了 以 下 几 个 页 签 ， 见 表 3-8。 
表 3-8 功能 模块 中 的 页 签 说 明 


页 签名 称 使 用 说 明 
Attributes 属性 页 ， 配 置 功能 模块 的 相关 属性 
Import 输入 参数 ， 类 似 Java 方法 中 的 输入 参数 
Export 返回 参数 ， 类 似 Java 方法 中 的 返回 参数 
Changing 输入 /输出 都 需要 使 用 的 参数 
Tables 功能 模块 用 到 的 表 和 结构 
Exceptions 功能 模块 抛 出 的 异常 参数 
Source code 功能 模块 的 源 代码 
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如 果 使 用 过 老 版 本 的 NWDS， 也 能 看 到 类 似 ECC 中 功能 模块 配置 页 的 “影子 ”， 其 中 
“Properties” 对 应 着 属性 页 签 ,，“Context” 对 应 着 参数 页 签 ,， “Implementation” 对 应 着 源 代 
码 页 签 ， 而 在 新 版 本 中 ， 上 下 文 、 方 法 、 事 件 等 内 容 都 统一 放 人 了 “Properties” 属 性 页 
Zh, Java 源 代码 也 独立 成 为 一 个 Java 文件 ， 并 可 以 通过 Java 编辑 器 进行 修改 ， 如 
图 3-260 所 示 。 


Properties | Context |Methods |Events | Implementation 
图 3-260 ”新 版 本 中 的 标签 


下 面 的 示例 RFC 包含 了 一 个 输入 参数 “I_Name” 和 一 个 表 参 数 “T_Pers”,， 其 中 “T_ 
Pers” 还 包含 了 其 他 4 个 字符 串 类 型 的 参数 : ID, NAME, DESC 和 RESERV， 如 图 3-261 
所 示 。 


结构 ZT5_001 lgs 
短文 本 估 员 结构 


Attributes “Components | Entry help/check 上“ 货币/ 数 里 字段 


KAREE MEEA] rredme Type 1/4 
Component Typing Method Component Type Data Type KE 小 数位 短文 本 
ib {i Types JD NUNC 8 0 业务 事件 的 对 象 标识 已 提供 
NAME 1 3 Y NAME CHAR 35 0 雇员 的 姓 
DESC 1 v DESC CHAR 20 0 Oracle: Time interval when 
RESERY 1 v ZRESERY CHAR 200 0 预 留 字段 


Al3-261 REC 中 的 参数 定义 


它 的 代码 逻辑 比较 简单 ， 作 为 测试 用 例 ， 直 接 返 回 员工 编号 “001”、 员 工 姓名 “bluse” 
和 员工 描述 “bluse name”， 如 图 3-262 所 示 。 


1 和 ztef_001. 


SAKE) TYPE WAWE 


10: | #*------ 


11: || CLEAR t_pers[]. 

12 t_pers-id = 001. 

13 t_pers-name = ‘bluse’. 

14 t_pers-name = “bluse name’. 
15 APPEND t_pers. 


21 “~ ENDFUNCTION. 


Al3-262 REC 的 逻辑 处 理 
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1. Web Dynpro 5 RFC 

本 节 主 要 介绍 在 Web Dynpro 中 如 何 使 用 RFC 类 型 的 模型 。 

开发 实例 : 

1) 首先 创建 一 个 新 的 Web Dynpro 工程 ， 并 命名 为 “mydynp03”， 如 图 3-263 所 示 。 


2) 随后 创建 一 个 组 件 ， 并 命名 为 “Dynp03_01Comp”， 在 创建 向 导 中 同时 默认 创建 视 
图 和 窗口， 如 图 3-264 所 示 。 


a © [LocalDevelopment] mydynp03 
4 yi Web Dynpro 
ES Applications 
@ Models 


[R Component Interfaces 
a 


a Dynp03 | 01Comp 


a Local ecto Interface 
3 Inherited Interfaces 


(PL Web Dynpro £3 kä Search Cons | 3 


à 


$< Custom Controllers 

@ Implemented Interfaces 
E] Message Pool 

& Used Models 

«i Used Components 


[= Te mydynp03 


& Dictionaries 


æ Resources 


图 3-263 创建 新 的 Web Dynpro 项 目 图 3-264 创建 新 的 组 件 


3) 创建 组 件 完毕 后 ， 右 击 “Models” 结 点 ， 在 弹出 的 快捷 菜单 中 选择 创建 模型 ， 在 随 
后 弹出 的 对 话 框 中 选择 第 一 项 “Adaptive RFC 2 Model”， 右 侧 是 一 些 相关 的 说 明 ， 单 击 
“Next” 按 钮 ， 如 图 3-265 所 示 。 


I New Model Se = -le 


Selecta model type 


oe 
This wizard provides a guides for creating Web Dynpro models 


Available Models: 


[ER Adaptive RFC 2 Model This wizard guides you through the various 
ig, Adaptive Web Service Model steps involved to create an Adaptive RFC 2 


S3 Enterprise JavaBean Model ee ee 
SZ Java Bean Model estination needs to be configured in the 
preferences. 
gz Adaptive RFC Model - DEPRECATED 


WR] 


3-265 ”选择 导入 类 型 


4) 输入 导入 后 的 模型 名 称 ， 以 及 程序 
图 3-266 所 示 。 


5) 如 未 配置 过 导入 RFC 服务 器 ， 则 单 击 图 2-266 中 的 “Configure R/3 Destination” 进 


行 服务 器 参数 的 配置 ， 以 便 开发 工具 连接 对 应 的 ABAP 系统 导入 RFC 模型 。 在 弹出 的 对 话 


了 时 使 用 的 服务 端 配 置 的 逻辑 目的 地 ， 如 
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FES New Model ques eee ere TE TTT el lt ) 


Import Adaptive RFC 2 Model s$ 


Create a Web Dynpro model from Adaptive RFC module definitions. The created model is adaptive inthe = $, & 
way that it synchronizes its metadata from the SAP back end at runtime. 


Model Name 


FindPersModel 


Model Package 


Default logical system name for model instances MT_RFC_EPD_MODEL_DEST 


Default logical system name for RFC metadata} MT_RFC_EPD_META_DEST 


Logical Dictionary FindPersModel 


Dictionary Types Package com.sap.demo.mydynp03.wd,models.findpersmodel, 


® ot | (ta 


页 


3-266 ”输入 模型 信息 


框 中 单 击 “Add” 按 钮 ， 随 后 选择 “Single Server” (一 般 需 要 选择 “Load Balancing” 
均衡 环境 进行 配置 ) 并 输入 服务 器 的 必要 信息 ， 如 图 3-267 所 示 。 


_ Add SAP Back End Information 
Add SAP Back End Information 


Single Server| Load Balancing 


10.12.33.11 


00 


图 3-267 输入 服务 器 连接 信息 
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6) 完成 服务 器 配置 后 ， 回 到 导入 模型 的 向 导 并 单 击 “Next” 按 钮 ， 如 无 法 连接 配置 ， 
则 系统 会 弹出 相应 的 提示 信息 ; 如 出 现 搜索 对 话 框 ， 则 表示 连接 成 功 见 图 3-268 所 示 。 


局 New Model wp i e o en) 


Select RFC Modules 
sÊ 
Š 


Select the RFC modules that need to be part of the model. You can either search for RFC modules or 
browse the application component hierarchy. 


aot 


Function Name Function Group Search 


Function Name Description Function Group 


网 3-268 搜索 RFC 对 话 框 


7) 输入 关键 字 “ZTE * _001”， 单 击 “Search” 按 钮 ， 搜 索 测 试 使 用 的 RFC， 随 后 选中 
需要 导入 的 REC 并 单 击 “Next” 按 钮 ， 如 图 3-269 所 示 。 


New Mode! nn 


Select RFC Modules 名 ô 


Select the RFC modules that need to be part of the model. You can either search for RFC modules or & 
browse the application component hierarchy. 


ots All Interfaces Zz 


H 


Function Name ZTE*_001 Function Group Í Search] 
Function Name Description Function Group 
加 A ZTEF 001 ZTE_001 
@ ZTESTOOL ZTESTOOL 


® [ <Back || Nea> |[ Enish || Cancel 


图 3-269 模糊 查询 对 应 REC 


8) 在 弹出 的 对 话 框 中 会 显示 导入 模型 所 涉及 的 表 、 字 段 和 结构 等 内 容 ， 并 生成 对 应 的 
接口 类 ， 单 击 “Finish” 按钮 完成 模型 的 导入 ， 如 图 3-270 所 示 。 

9) 导入 完成 后 就 能 在 “Models” 结 点 下 看 到 导入 成 功 的 模型 了 ， 如 图 3-271 所 示 。 

10) 导入 完成 后 ， 首 先 需 要 声明 对 该 模型 的 使 用 ， 进 入 创建 的 Web Dynpro LE, AE 
“Used Models”， 在 弹出 的 快捷 菜单 中 选择 添加 之 前 导入 的 模型 ， 如 图 3-272 所 示 。 
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New Model 


Rename Adaptive RFC 2 Model Classes 


name is invalid or already exists, it will be reverted back to the original value. 


od 


You can rename the model classes under column "Editable Model Class Names". If the entered model class oS 


ABAP Name Suggested Model Class Names Editable Model Class Names 
BAPIRET2 Bapiret2 Bapiret2 
ZTS_001 Zts_001 Zts_001 


ZTEF_001_Input Ztef_001_Input Ztef_001_Input 
ZTEF_001_Output Ztef_001_Output Ztef_001_Output 


Restore Defaults 


@ | < Back 


| Finish 


Ly 


3-270 SAW AT 


1S [LocalDevelopment] mydynp03 
4 yi Web Dynpro 

> ES Applications 

4 加 Models 


> | FindPersModel | 


> JÀ PerInfoModel 


Component Interfaces 
> «&) Components 
> @ Dictionaries 
> @ Resources 


国 Message Pool 


BS 


Add 


@ Implemented Interfaces 


3-271 导入 后 的 模型 效果 图 3-272 ”添加 使 用 模型 


Compare Metadata 


11) 选中 “FindPersModel” 模 型 ， 单 击 “OK” 按 钮 即 完成 了 添加 ， 如 图 3-273 所 示 。 
12) 随后 右 击 “Custom Controllers” 在 弹出 的 快捷 菜单 中 选择 “Apply Template”， 自 动 
创建 对 应 的 调用 方法 和 上 下 文 ， 在 弹出 的 对 话 框 中 选择 “Service Controller” 并 使 用 默认 名 


称 ， 单 击 “Next” 按 钮 ， 如 图 3-274 所 示 。 


r 
Apply Template 


Erm) 


Select Template 


Select a template 


á | Dynp03_01Comp Template Instance Name | 
只 Component Controller Available Templates: 
D Local Component Interface E Service Controller 
> $æ Custom Controllers HHGP Callable Object 


4 Implemented Interfaces 


@, FindPersModel 


Qa PerInfoModel iets | 


Finish 


3-273 ”完成 模型 添加 后 的 效果 


图 3-274 选择 模板 类 型 
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13) 选中 要 使 用 的 模型 ， 单 击 “Next” 按 钮 ， 如 图 3-275 所 示 。 
TES Apply Template ve crc x | 


Select an Executable Model Class 

The list of models is filtered, Supported model types are Adaptive RFC1, Adaptive RFC2, WebService, 

Adaptive WebService & EnterpriseJavaBean 

Controller FindPersModelController0 
FindPersModel 

a Z FindPersMod 
® Ztef_001_Input 

PerlnfoModel 

(?) Jack | Next > | [ Finish e] | Cancel 


Ly 


3-275 ”选择 对 应 模型 


14) 选择 创建 对 应 的 上 下 文 特性 并 映射 的 模型 的 结构 和 参数 ， 单 击 “Finish” 按 钮 ， 如 
图 3-276 所 示 。 


Apply Template 


Model Binding 


Select the context elements you want to bind. Rename them by clicking the corresponding item in the 
|_list on the right. 


4 HO Context Name Model Class or... Model .… 
[i ztef 001 Input AT Pers_1 Zts_001 T_pers 
4 VA Output 
> MA E Return 


> A TPers 


回回 TPers_1 
T & LName 


S] 


Resolve bindings according to context element name. Existing bindings will be replaced 


< 


Automatically resolve name clashes 


@ | < Back | Next > | | Einish | | Cancel 


3-276 ”确认 模型 中 的 参数 


15) 完成 自 定 义 控制 器 的 创建 后 ， 保 存 所 有 修改 即 二 Tp 


{e Component Controller 


可 ， 如 图 3-277 所 示 。 整 个 过 程 从 导 和 模型， 声明 引 1 

用 ， 再 到 创建 自 定 义 控制 器 ，Web Dynpro 已 经 将 复杂 多 [aaveaseaaa ] 

样 的 后 台 服 务 统一 定制 为 标 有 固定 输入 /输出 的 模型 ， eee $r 

且 通 过 自 定义 控制 就 可 以 调用 接口 中 的 方法 并 传递 参 [Z] Message Poo! 

数 ， 在 后 续 的 开发 过 程 中 ， 开 发 人 员 就 不 再 需要 关心 接 a pean 
口服 务 本 身 ， 只 专注 于 自 定义 控制 的 方法 调用 以 及 上 下 @a PerinfoModel 

文 映射 即 可 。 图 3-277 创建 自 定义 控制 器 后 的 效 一 
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16) 同样 地 ， 仿 照 Web Service 中 视图 对 服务 的 调用 ， 编 写 RFC 的 调用 过 程 。 首 先 新 建 
“Dynp03_01Comp_02View” 视 图 ， 接 着 在 组 件 控 制 器 中 添加 上 下 文 的 映射 ,最 后 在 视图 的 控 
制 器 中 编写 赋值 请 求 数据 以 及 解析 响应 代码 。 

17) 添加 视图 到 组 件 控制 器 ， 再 到 自 定 义 控制 器 的 引用 关系 ， 如 图 3-278 所 示 。 


Dynp03_01 
Comp_0.… 
& 


Component 
Controller 
& 


s$ 


Dynp03_01 
Comp_0... 
& 


Le a gp ay ae ee eg oy et et ge ay n Dynp03_01 
Compint... 


FindPersMo 
delContr... 


& 


“yy 


PerInfoMo 


delContr... 


aPerInfoMo 
dd 


@aFindPersMo 
da 


图 3-278 添加 引用 关系 
18) 完成 从 组 件 控制 器 到 自 定 义 控制 器 的 上 下 文 映射 ， 如 图 3-279 所 示 。 


Context Mapping po |e 


Select the context elements to map 


Drag from right to left to create and map a new element in the left tree. 
Drag from left to right to map an existing element. 


Dynp03_01Comp FindPersModelController: 


© Context 4 © Context 
C GetPerName "a $) Ztef 001 Input 
GetPerNameResponse 4 团 Output 
加 EReturn 
E Ztef.001_Inpu — [ST Pers] 


B® LName 


图 3-279 配置 上 下 文 映 射 
19) 完成 从 视图 到 组 件 控制 器 的 上 下 文 映射 ， 如 图 3-280 所 示 。 


Context Mapping 


Select the context elements to map 


Drag from right to left to create and map a new element in the left tree. 


Drag from left to right to map an existing element. 
Dynp03_01Comp_02View Dynp03_01Comp 


© Context 4 © Context 
CQ) T Pers 4 > EQ) GetPerName 
C Ztef_001_Input-~ x C) GetPerNameResponse 
> A T Pers 
> a Ztef_001_Input} 


图 3-280 配置 上 下 文 映 射 
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20) 在 组 件 控制 絮 中 添加 新 的 自 定 义 方法 “executeFindPer”， 如 图 3-281 所 示 。 
21) 封装 方法 逻辑 : 


public void executeFindPer( ) | 
//@ @ begin executeFindPer( ) 
wdThis. wdGetFindPersModelControllerController(). executeZtef_001 () ; 
//@ @ end 

| 


22) 在 视图 中 添加 一 个 按钮 ， 并 创建 默认 的 响应 事件 ， 如 图 3-282 所 示 。 


< Component Controller 


General 
References | oo 
Context 

Methods 


type filter text 


GR executeFindPer - void | 
全 executePerinfo - void 


Event Handlers 


Events 


图 3-281 添加 自 定 义 方 法 图 3-282 添加 按钮 
23) 响应 事件 的 代码 逻辑 如 下 : 
wdContext. nodeZtef_001_Input( ). currentZtef_001_InputElement( ). setL_Name(" 王 明 " ) ;// WME f 


// 入 参数 
wdThis. wdGetDynp03_01CompController( ). executeFindPer( ) ;// 执 行 调用 服务 方法 


24) 根据 映射 的 上 下 文 返回 参数 ， 如 图 3-283 所 示 。 
25) 使 用 应 用 模板 方式 创建 表格 元 素 ， 如 图 3-284 所 示 。 


m Last name EventID | Reserv Desc 
ma a @Name @id @Resery @Desc 
f E] & Desc | @Name @id @Reserv @Desc 
F B id | | @Name @id @Reserv @Desc 
W g Name 
网 B Reserv 


图 3-283 ”选择 上 下 文 图 3-284 创建 表格 元 素 后 的 效果 
26) 测试 运行 。 创 建 Dynp03_01Comp_02App， 编 译 、 部 署 并 运行 ， 运 行 效果 如 图 3-285 
所 示 。 单 击 “Button” 按 钮 后 就 能 模拟 查询 动作 ， 列 表 显 示 RFC 返回 结 


je 姓 事件 标识 Reserv Desc 


图 3-285 运行 效果 
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27) 编辑 后 台 REC 函数 ， 增 加 一 条 返回 记录 ， 如 图 3-286 所 示 。 


CLEAR t_pers[]. 
t_pers-id = 
t_pers-name = “blu 
t_pers-name = `b 
APPEND t_pers. 
t pérs-id = 
t_pers-name = ` Mike’. 
t_pers-name = ‘Mike na 
APPEND t_pers. 
t_pers-id = S 
t_pers-name = 

t_pers-name = ` 

APPEND t_pers. 


图 3-286 REC 代码 示例 


28) 再 次 单 击 “Button” 按 钮 ， 列 表 


= 
更 新 ， 如 图 3-287 TAR o fe # 事件 标识 Reserv | Desc 
2. Java 5 RFC ms bluse name 00000001 
在 脱离 Web Dynpro 的 情况 下 JE Ja- | 儿 | Mike name 00000002 
Tony name 00000003 


va 代码 中 可 以 通过 SAP 提供 的 JCO 连接 
器 进行 REC 的 调用 。Java 代码 调用 REC 
有 两 种 方式 ， 一 种 是 引用 第 三 方 Jar 包 ， 
创建 RFC 连接 池 并 维护 代码 与 RFC 之 间 
连接 关系 ， 然 而 这 种 方式 RFC 的 连接 信 
息 和 登录 信息 都 未 通过 服务 端 配置 ， 维 护 较 为 困难 ; 另外 一 种 是 引用 SAP 提供 的 LIB 类 库 
包 ， 通 过 API 调用 REC 的 方式 与 Web Dynpro 中 上 自 定 义 控制 器 的 调用 的 方法 相似 ， 并 且 将 程 
序 运行 时 REC 的 连接 信息 通过 逻辑 目的 地 配置 在 服务 端 维护 。 前 一 种 方式 在 网 上 有 很 多 人 
分 享 ， 本 节 将 对 后 一 种 方式 的 开发 过 程 进行 介绍 。 

更 多 SAP JCO 相关 的 类 库 和 JAR 包 资 源 ， 可 以 通过 官方 链接 进行 下 载 : 

http ;//service. sap. com/connectors 
通过 一 个 开发 实例 了 解 Java 调用 RFC 的 整个 过 程 : 首先 创 建 一 个 类 库 工程 并 包含 SAP 
JCO 连接 器 的 包 文 件 ， 随 后 创建 一 个 Java 工程 并 依赖 于 类 库 工 程 ， 同 时 在 Java 工程 中 完成 
REC 的 调用 逻辑 ， 最 后 创建 一 个 Web Dynpro 工程 并 依赖 于 Java 工程 ， 在 视图 的 按钮 中 直接 
调用 Java 工程 方法 即 可 。 

开发 实例 : 

1) 首先 创建 一 个 测试 用 的 Web 服务 ， 在 NWDS 中 单 击 右上 角 的 视图 切换 按钮 ， 切 换 到 
DI 透视 图 ， 如 图 3-288 所 示 。 

2) 右 击 “MyComponents” 自 定义 的 SC 目录 (黄色 结 点 )， 选择 创 建 一 个 “Develop- 
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AI 3-287 单 击 “Button” 按 钮 的 效果 


ment Component”, WKI 3-289 所 示 。 


New > || 5) Development Component... 
Show In >| «jy Development Configuration... 
Resync DCs... MyComponents 

&® Build Contained Local DCs 

X Delete me MyComponents 
Paste... demo.sap.com 

ùs Import 

tA Exporter MyComponents 
View SC Description 

E yw Web Dynpro 7° Java GB Release 
< “Search for DC... 


Al 3-288 切换 到 DI 透视 图 图 3-289 创建 开发 组 件 


3) 在 弹出 对 话 框 中 选择 “External Library” WP Enterprise Portal 
(SUPA 3-290), Bit “Next” PZH E External Library | 
4) 在 弹出 的 对 话 框 中 输入 工程 名 称 ( 见 E Java 
RI 3-291), 单 击 “Finish” 按 钮 完成 类 库 工 程 的 
创建 。 


图 3-290 选择 项 目 类 型 


IE New Development Component (Project) Ta 
New Development Component 
Create New Development Component (Project) 2 
Vendor: demo.sap.com x 
Name: ~ | mylib01 
Caption: 
Language: [American English "| 
Domain: | Basis 5 | 
Support Component: a 
(For Example BC-DWB-FOO) 
Keep DC Local for Now (Use ‘Add to Source Control’ Later) 


Ly 


3-291 输入 工程 名 称 


5) 工程 创建 完成 后 ， 将 “sapjco3. jar” 复 制 到 工程 的 “libraries” 目录 中 ， 如 图 3-292 
所 示 。 

6) 继续 在 DI 视图 中 进行 公开 声明 ， 选 中 “mylib01” 工 程 ， 打 开 右 侧 的 “Public Parts” 
fr, Ait “Manage Entities”， 如 图 3-293 所 示 。 


*Da mylib01 
- Overview | Dependencies | Public Parts | Child DCs 
4 & [LocalDevelopment] mylib01 = 
eS cfg Defined Public Parts 
Rp Specify the list of public parts for this DC 
Db def @ an 
> & gen - E ar X Delete 
4 ie libraries Reference Entities 
$ sapjco3jar Manage Entities 
& src &@ Refresh Children 
@ test 


Al 3-292 添加 JAR 文件 图 3-293 管理 实体 的 菜单 选择 
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7) 在 随后 弹出 的 窗口 中 选中 “sapjco3. jar” 完 成 添加 ， 在 archives 中 也 同样 添加 “sapj- 
co3. jar” WZH (ILEI 3-294), 保存 所 有 修改 。 

8) 接着 进行 Java 工程 的 创建 调用 RFC 测试 。 再 次 右 击 “MyComponents” 自 定义 
的 SC HR, W “Development Component”， 如 图 3-295 所 示 。 


New > | Development Component... 
Show In af Development Configuration... 


Resync DCs... MyComponents 
&® Build Contained Local DCs 
里 Delete MyComponents 
Overview Dependencies Public Parts | Chil 
=. Ss aon Paste... d 
emo.sap.com 
Defined Public Parts 
r P K A ùs Import 
Specify the list of public parts for this DC A Epon MyComponents 
a [E apil View SC Description 
á sapjco3jar GB Release 


(m i r 
4 E archives “Search for DC... 
á sapjco3.jar 人 Refresh 


图 3-294 添加 后 效果 图 3-295 创建 开发 组 件 的 菜单 选择 


9) 在 弹出 对 话 框 中 选择 “Java” 类 型 ( 见 图 3-296 ) ， Peer 
随后 单 击 “Next” 按 钮 。 E Java 

10) 在 弹出 的 对 话 框 中 输入 工程 名 称 “myjav03” (JL @ Java EE 
| 3-297), Adi “Finish” H, 

11) 继续 在 DI 视图 中 进行 类 库 工 程 的 依赖 ， 选 中 “my- 
jav03” 工 程 ， 打 开 右 侧 的 “Dependencies” 标 签 ， 单 击 “Add” 按 钮 ， 如 图 3-298 所 示 。 


图 3-296 选择 项 目 类 型 


New Development Component (Project) = Lo) 

New Development Component 

Create New Development Component (Project) TE 
Vendor: demo.sap.com = 
Name: myjav03| 

Caption: 

Language: [American English "| 
Domain: | Basis X | 
Support Component: v, 

(For Example BC-DWB-FOO) 


图 3-297 输入 工程 名 称 


12) 在 弹出 对 话 框 中 找到 之 前 创建 的 “mylib01” 工 程 并 选中 ， 如 图 3-299 所 示 ， 单 击 
“Finish” 按钮 。 
13) 接着 进入 Java 工程 ， 创 建 RFC 调用 类 “RFCInvoke”， 如 图 3-300 所 示 。 
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Overview | Dependencies | Public Parts | Child DCs | Permissions Folders | Cus 


Required DCs 
Specify the list of DCs required for this DC 


3-298 添加 项 目 依 赖 


Add Dependencies E 


Choose DCs to be referenced 2 


*mylib* 


4 E QS LocalDevelopment 
H EA MyComponents [demo.sap.com] 

V Det mylibo1 
| 


4 & [LocalDevelopment] myjav03 


4 (SS src 


4 册 com.myproject.rfcclient 


Finish | | Cancel z 
四 RFCInvokejava 


图 3-299 选择 依赖 工程 图 3-300 创建 Java 类 


14) 其 中 调用 的 参考 代码 如 下 : 


public class RFCInvoke | 
private String DEST = ""MT_RFC_EPD_MODEL_DEST" ; // Destination Name 
private String RFC_NAME = "ZTEF 001" ;//RFC Name 
public List < String > callRfc( String i_name) throws Exception | 


JCoDestination destination ; 
JCoFunction function; 
// 获取 RFC Destination 
try | 
destination = JCoDestinationManager. getDestination( DEST) ; 
} catch( JCoException e) | 
throw new Exception( " DESTINATION ERROR;" + DEST, e); 
| 
// 获取 REC 函数 
try | 
function = destination. getRepository(). getFunction( RFC_NAME) ; 
} catch( Exception e) | 
throw new Exception( "RFC NOT FOUND!" + RFC_NAME, e); 
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| 
try | 
// 使 用 JcoFunction 对 象 给 服务 赋值 

JCoParameterList importParameterList = function 

. getImportParameterList( ) ; 

// 赋值 输入 参数 

importParameterList. setValue( "I_NAME" , i_name) ; 
| catch( Exception e) | 

throw new Exception("" + RFC_NAME + " INPUT PARA 
| 
// 执行 RFC 
try | 

function. execute (destination) ; 
| catch( Exception e) | 


| 
// 获取 返回 参数 
try| 
JCoParameterList tableParameterList = function 
. getTableParameterList( ) ; 
JCoTable tPers = tableParameterList. getTable('"T_PERS" ) ; 
if( null != tPers) | 
List list = new ArrayList( ) ; 
for(int i =0; i< tPers. getNumRows( ); i++ ) | 
tPers. setRow(i) ; 
String name = tPers. getString( " NAME" ) ; 
list. add( name) ; 


| 


return list; 


| 


} catch (Exception e) | 
throw new Exception( RFC_NAME + "", e); 
| 


return null; 


| 


throw new Exception( "RFC " + RFC_NAME + "EXECUTE ERROR!", e); 


METER ERROR!", e); 


// 获取 一 个 参数 


15) HEA “Public Parts”， 将 Java 工程 的 类 进行 公开 ， 如 图 3-301 所 示 。 


16) 建立 EAR 工程 依赖 并 部 署 Java 工程 ， 如 图 3-302 所 示 。 


Overview Dependencies | Public Parts | Child DCs Required DCs 


Defined Public Parts Specify the list of DCs required for this DC 


Dependency Details 
Define the properties of 


a*a myjav03 


Specify the list of public parts for this DC 


—_ zm 
4 & api Add Es 


E api 


F] Deploy Time 


com 


&& com 


Be 
Add... 


Resolve All 


图 3-301 添加 公共 部 分 图 3-302 ”添加 工程 依赖 


17) 选择 任意 一 个 测试 用 的 Web Dynpro 工程 ， 在 依赖 中 添加 对 “myjav03” 工 程 的 依 


赖 ， 如 图 3-303 所 示 。 
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PEI JE 
4 Da myjav03 
EF api eh Deploy Time 


Design Time 


RF ass 

b Ba te/aii/base/offline/facade = 
》 Da4 te/bl/exception/lib Resolve All 
b Ba te/bl/logging/api 

> Da tc/cmi 

> 4 tc/ddic/runtime/facade 


V] Runtime strong + 


D Bq tc/je/scheduler/api 
> Th tc/wd/api 


图 3-303 ”添加 工程 依赖 


18) 保存 所 有 修改 并 编译 后 ， 在 视图 中 创建 一 个 按钮 并 创建 对 应 
动作 ， 如 图 3-304 所 示 。 

19) 在 Java 编辑 需 中 ， 添 加 动作 的 事件 处 理 器 代码 ， 创 建 “my- 图 3-304 运行 效果 
jav03” 对 象 并 调用 其 方法 。 


//@ @ begin onActionRfc( ServerEvent ) 
RFCInvoke invoke = new RFCInvoke( ) ; 
try | 
List < String > callRfe = invoke. callRfc(" Bluse" ) ; 
for (int i = 0; i < callRfe. size(); i+ +) | 
wdComponentAPI. getMessageManager( ) 
. reportSuccess ( callRfe. get(i) ) ; 
| 
} catch (Exception e) | 
// TODO Auto - generated catch block 
wdComponentAPI. getMessageManager( ) 
. reportException(e. getMessage() ) ; 
| 
//@ @ end 


20) 保存 所 有 修改 ， 并 将 所 有 工程 部 署 至 服务 需 端 后 ， 即 可 和 运行， 运行 效 果 如 网 3-305 
Ais} 


所 示 。 
21) 单 击 “RFC” 按 钮 后 就 能 得 到 REC 的 返回 消息 ， 如 图 3-306 所 示 。 


= bluse name 


图 3-305 运行 效果 K 3-306 单 击 按钮 后 的 效果 


3.7.3 Web 服务 模型 实例 


1. Web 服务 的 定义 与 测试 

关于 Web 服务 (Web Service) 的 概念 这 里 不 再 歼 述 。 下 面 通过 了 JB 创建 一 个 简单 的 
Web 服务 。 对 于 NetWeaver 平台 (或 者 说 是 Web Dynpro For Java 对 应 的 PEE 应 用 服务 妖 ) 
而 言 ， 所 有 的 应 用 程序 都 是 通过 打包 为 EAR 的 文件 进行 部 署 的 。 所 以 ，WebService 服务 创 
建 包括 创建 EJB 工程 、 创 建 EAR 工程 、 配 置 Web 服务 等 几 个 步 又 。 

开发 实例 : 

1) 首先 创建 一 个 测试 用 的 Web 服务 ， 在 NWDS 中 单 击 右 上 角 的 视图 切换 按钮 ， 切 换 到 
DI 视图 (Development Infratructure perspective ) 。 
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2) 右 击 “MyComponents” 自 定义 的 SC 
ment Component”， 如 图 3-308 所 示 。 


目录 (黄色 结 点 ) ， 选 择 创建 一 个 “ Develop- 


图 PL Web Dynpro Y? Jav 


Development Infrastructure perspective 


Sx Pf BE 


3-307 


New 
Show In 


Resync DCs... 
Build Contained Local DCs 
Delete MyComponents 


MyComponents 


Paste... 


demo.sap.com 


Import 
Export... 
View SC Description 


MyComponents 


Release 


Search for DC... 
Refresh 


3-308 创建 开发 组 件 


3) 在 弹出 的 窗口 中 选择 对 应 的 EJB 类 型 ， 单 击 “Next” 按 钮 ， 如 图 3-309 所 示 。 
4) 输入 自 定义 DC 的 名 称 ， 单 击 “Next” 按 钮 ， 如 图 3-310 所 示 。 


局 New Development Component Project) SN cn lass 


New Development Component 
Select Development Component Type. 
Type: 
4 ® sap.com a 
E Composite Application 
> 节 Content 
b DC Build 
G Dictionary 


> WP Enterprise Portal | 
External Library 
@ Java 

4 @& JavaEE 


(© Enterprise Application 
Web Module 
DD Process Composer 


© Rules Composer 
QË Service Composer 一 


© Service Group Configuration 
> SM Software Logistics 
fi Text = 
Supported DC Type 


@ 


[局 New Development Component (Project) ES 


New Development Component 

Create New Development Component (Project) 2 

Vendor: demo.sap.com 

= T 

Caption: myejb01 

Language: American English Š 
| Domain: Basis E 
MN Support Component: ~ 


(For Example BC-DWB-FOO) 


[Z] Keep DC Local for Now (Use ‘Add to Source Control’ Later) 


Preferences 


@ [<Back Next > Finish Cancel 


3-309 选择 项 目 类 型 


图 3-310 输入 项 目 信 息 


5) 根据 实际 需求 ， 选 择 正确 的 Java EE 版 本 ( 见 图 3-311)， 单 击 “Finish” 按 钮 。 
6) 创建 完成 后 ， 进 入 Java EE WK, Ai EIB 工程 ， 选 择 创建 一 个 “Session Bean”, 


如 图 3-312 所 示 。 


7) 按照 命名 规范 输入 自 定义 的 包 名 和 类 名 ( 见 图 3-313)， 单 击 “Finish” 按 钮 ， 完 成 


EJB 创建 。 
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Enterprise Bean Module Project 


Create a new EJB module project 


Project Name: | LocalDevelopment~myejb01~demo.sap.com 


Java EE Version: 


Location 


@ Create project in the workspace 


Create project at external location 


Directory: [D:\n730_wk_nbk01jdi\LocalDevelopment\DCs\demo.sap.com\myejb01\_comp | | Browse | 


JPA Settings 


El Use JPA 


JPA Version: 


图 3-311 确认 编译 版 本 
New >| Fe} Project... 
Go Into 加 DTD 
Open Type Hierarchy F4 | [xy XML 
Show In Alt+Shift+W > Bt XML Schema 
a 
E Copy cule | a XL 
§ Copy Qualified Name @ Annotation 
岛 Paste Ctrl+V |@ Class 
里 Delete Delete |G Enum 
© Remove from Context Ctrl+Alt+Shift+Down | @ Interface 
Build Path >| BY Package 
Source Alt+Shift+S > | § Source Folder 
Refactor Alt+Shift+T > Eg Message-Driven Bean (EJB 3.) 
Ey Import... R Session Bean (EJB 3.x) 
A 
ci Export... Fi Example... 
2) | Refresh F5 iry Other... Ctrl+N 


图 3-312 创建 EJB 的 菜单 选择 


8) 创建 完毕 后 ， 可 以 看 到 开发 工具 自动 为 EJB 工程 生成 了 一 个 空 的 类 并 实现 了 一 个 接 
口 类 ， 如 图 3-314 所 示 。 

9) 创建 一 个 自 定义 方法 ， 本 例 直 接 返 回 一 个 字符 串 进行 测试 ， 加 入 下 列 代 码 ， 
见 图 3-315 : 


return " ÆHH" ; 


10) 打开 本 地 接口 类 的 Java 编辑 器 ， 添 加 方法 的 声明 ， 见 图 3-316 : 


public String getPerName(String perld) ; 


124 


Create EJB 3.x Session Bean 


Specify class file destination. 


EJB project: | LocalDevelopment~myejb01~demo.sap.com na 


Source folder: /LocalDevelopment~myejb01~demo.sap.com/ejbModule 


Java package: com.myproject 


PerInfoWs| 


Superclass: 


Create business interface 


Remote | com.myproject.PerInfoWsRemote 


Local com.myproject.PerInfoWsLocal 


Al3-313 输入 项 目 信 息 


1 package com.myproject; 


2 

3 import javax.ejb.Stateless; 

4 

5Se/** 

6 * Session Bean implementation class PerInfoWs 
了 | *f 


8 @Stateless 
9 public class PerInfoWs implements PerInfoWsLocal { 


10 

116 f** 

12 * Default constructor. 

13 *y 

1498 public PerInfoWs() { 

Ais // TODO Auto-generated constructor stub 
16 } 


17 


图 3-314 ”自动 生成 的 类 


public class PerInfoWs implements PerInfoWsLocal { 


/** 

* Default constructor. 
w/ 

public PerInfoWs() { 


// TODO Auto-generated constructor stub PerInfoWs,java 
} 1 package com.myproject; 
2 import javax.ejb.Local; 
@Override 3 
public String getPerName (String perId) { 4 @Local 
ated method stub 5 public interface PerInfoWsLocal { 
} 7 
8 } 
} 9 
图 3-315 ”添加 代码 1 图 3-316 添加 代码 2 


至 此 ， 一 个 简单 的 EJB 创建 完毕 。 创 建 一 个 PerInfoWs 的 EJB， 该 EIB 包含 对 个 人 信息 
的 操作 ， 同 时 只 添加 了 一 个 返回 个 人 姓名 的 方法 。 
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11) 接 下 来 ， 基 于 该 BJB 创建 对 应 的 Web Service。 再 次 定位 刚刚 建立 的 Session Bean, 
右 击 工程 ， 在 弹出 的 快捷 菜单 中 选择 “Web Services” 一 “Create Web Service”， 创 建 一 个 
Web Service ， 如 图 3-317 所 示 。 


Replace With Resource Path _— 


Restore from Local History... 


Development Component As | | 
Web Services Create Publication Information... 


Properties Alt+Enter 


图 3-317 创建 Web 服务 的 菜单 选择 


12) 在 弹出 的 对 话 框 中 ,将 配置 级 别 的 滑 块 选择 “Develop Service” 开 发 级 别 服务 ， 单 
击 “Next” 按 钮 ， 如 图 3-318 所 示 。 


Web Services 
Select a service implementation or definition and move the sliders to set the level of service and client generation. 


Web service type: Bottom up Java bean Web Service 下 
Service implementation: sctperinfoWs — a E ~ [Browse..| 


图 3-318 配置 Web 服务 属性 


13) 由 于 创建 Web 服务 需要 指定 接口 ， 因 此 单 击 浏览 按钮 进行 选择 ， 如 图 3-319 
所 示 。 
14) 选择 之 前 在 代码 中 实现 并 声明 的 接口 方法 ， 单 击 “OK” 按 钮 ， 如 图 3-320 所 示 。 


FS) SEI Selection [me E We 
Service Endpoint Interface Select Service Endpoint Interface X 
© Specify the qualified name of interface “Local 


© Do not use an explicit service endpoint interface © PerinfoWsLocal - com.myproject 


 com.myproject - LocalDevelopment~myejb01~demo.sap.com/ejbModule 


@ =| 


3-319 选择 接口 3-320 ”选择 接口 方法 


后 面 的 步 又 均 使 用 默认 选项 直至 创建 完毕 。 
15) 再 次 进入 DI 视图 ,创建 一 个 EAR 工程 ， 用 于 依赖 EJB 工程 并 部 署 至 服务 器 端 。 选 
择 新 建 类 型 为 “Enterprise Application”， 如 图 3-321 所 示 ， 单 击 “Next” 按 钮 。 
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New Development Component 


Select Development Component Type. 


p sap.com 
Composite Application 
Content 
DC Build 
Dictionary 
Enterprise Portal 
External Library 
Java 
Java EE 
EJB Module 
Web Module 
DD Process Composer 
RB Rules Composer 


QË Service Composer 

© Service Group Configuration 
> > Software Logistics 

i Text 


Ly 


3-321 选择 项 目 类 型 


16) 根据 实际 的 命名 规范 ， 输 入 自 定义 ear 名 称 〈 见 图 3-322) ， 单 击 “Next” 按 钮 。 


New Development Component (Project) 


New Development Component 


Create New Development Component (Project) 


Vendor: demo.sap.com 


Name: -[meanol | 


Caption: myear01 


Language: American English 


Domain: Basis 


Support Component: 


(For Example BC-DWB-FOO) 


Keep DC Local for Now (Use ‘Add to Source Control’ Later) 


Preferences 


图 3-322 ”输入 项 目 信 息 
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17) 根据 实际 需求 ， 选 择 对 应 的 Java EE 版 本 ， 如 图 3-323 所 示 ， 单 击 “Next” 按 钮 。 


Enterprise Application Project 


Create a new Enterprise Application project 


Project Name: | LocalDevelopment~myear01~demo.sap.com | 
Java EE Version: 
Location 


@ Create project in the workspace 


Create project at external location 


Directory: | D‘\n730_wk_nbk01 jdi\LocalDevelopment\DCs\demo.sap.com\myear01\_comp | | Browse | 


3-323 ”选择 对 应 的 编译 版 本 


18) 选中 对 应 引用 的 EJB 工程 ( 见 图 3-324)， 单 击 “Finish” 按 钮 。 
19) 保存 所 有 修改 ， 完 成 两 个 工程 的 创建 ， 如 图 3-325 所 示 。 


New EAR Project 


Description 


| Referenced Projects: 


> @ META-INF 
@ src 
@ test 


> & [LocalDevelopment] myejb01 


3-324 选择 引用 的 EJB 项 目 图 3-325 创建 后 的 效果 


20) 通过 开发 组 件 的 菜单 进行 编译 并 部 署 EAR 工程 ， 将 创建 的 Web Service 发 布 到 服务 
ft, Hitt EAR 工程 名 ， YE “Development Component” 一 “Build” 进 行 编 译 ， 编 译 完 成 后 
在 同一 菜单 中 选择 “Deploy” 进 行 部 署 ， 如 图 3-326 所 示 。 

21) 下 面 验证 一 下 Web 服务 是 否 部 署 成 功 。 用 管理 员 账号 登录 服务 咒 NWA 管理 页 面 ， 
并 进入 “NWA” 一 “Configuration” — “Connectivity” — “Single Service Administration” , 
如 图 3-327 所 示 。 

22) 在 搜索 条 件 中 输入 “* PerInfo* ”， 单 击 “Go” 按 钮 ， 如 图 3-328 所 示 ， 搜 索 创 建 
的 Web 服务 。 

23) 已 成 功 找到 对 应 的 Web 服务 ， 证 明 部 署 成 功 ， 如 图 3-329 所 示 。 
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Close Unrelated Projects Show In » 


Validate Synchronize 


Compare Metadata $% Build 
Run As Deploy... 


p 
Debug As r Update Project Settings 
Profile As x Enable Unit Test Support 
Team , z 
Compare With 5 Migrate to oe Component 
acacia Woes (seek taco Convert Project to Development Component... 
Configure Label Decoration... 
Java EE Tools K 


Development Component Log on 


Ly 
P 
S 
zx 
Ne 
图 
= 
& 
ši 
Z 
i 
F 


Java HTTP Provider Configuration Views, 
Virtual Host can act as several different Web serve) 


but referring only to a single real IP address. A us 


多 Destinations Views. al 
7 他 Applications or services can establish connections to other services. When using E 


connections of this type, you need to specify the remote service address and the 


user authentication information to use for the connection. Many applications use the different configuration settings for each of the vi 

Destination service for this purpose. created and configured. Logon load balancing incre 

JCo RFC Provider workgroups. To improve performance and system 
mo The JCo RFC Provider Service processes ABAP to Java requests, and dispatches are distributed across available application servers 
Q DD the calis to Java applications. Seen from an ABAP system, it provides an RFC workgroup services and load sensitivity. 


destination. Technically, the service is based on the JCo (SAP Java Connector). To =] ian Views 
receive calls from ABAP, JCo servers are started and registered at the gateways E sna Sen ice Administration 7 oa Ar 


of the ABAP systems. The configuration of these JCo servers is done here. Fae Web - - 一 
Value Hel SEM! Single Service Administration } 


Configure and manage the Value Help (F4 Help) alias settings. The configuration is 
primarily used to accelerate user input in custom developed user interfaces. 


图 3-327 NWA 平 台中 的 独立 服务 管理 


Single Service Administration: Service Definitions 


Favoritos, Relaiad Unks, GoTo, Suppor Deisis 


r Consumer Proxies 
D nowe 
Find Penso _ Search by WSOL Pert Type Name ~ Sise CA -| 
Found Service Definitions: 1 
四 WSOL Port Type Name a Namespace 
“(mee 


Ly 


3-329 ”搜索 服务 结果 


24) 在 下 面 的 WSDLs 中 ， 可 以 看 到 Web 服务 对 应 | detaite about service definition "PerinfoWsLocar 
的 WSDL 地 址 ， 单 击 “Test” 按 钮 对 功能 进行 测试 ， 如 penan 
KI 3-330 所 示 。 

25) 在 测试 向 导 中 选择 需要 测试 的 方法 ， 选 择 自 定 | | 
义 创建 的 “getPerName” 方 法 (SLA 3-331), 单 击 图 3-330 获取 WSDL 信息 
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“下 一 步 ” 按 钮 。 
26) 由 于 方法 不 需要 输入 参数 ( 见 图 3-332)， 因 此 直接 单 击 “Next” 按 钮 即 可 。 


Te 


me us le WR 


SIEN) ELCA EEN EEE 


图 3-331 测试 对 应 服务 图 3-332 输入 参数 值 


27) 运行 结果 右 侧 显示 了 服务 正确 返回 的 执行 结果 ， 功 能 测试 完毕 ， 如 图 3-333 所 示 。 


EE OSDIR "psiPerName™ 


图 3-333 ”运行 效果 


通过 上 面 的 验证 ， 说 明 Web 服务 已 经 正确 创建 并 发 布 至 服务 器 。 

其 实 创建 Web 服务 的 方式 有 很 多 ， 对 Java 来 讲 就 有 很 多 ， 更 何况 延伸 至 不 同 的 平台 都 
有 对 应 的 发 布 Web 服务 的 方式 。 这 里 介绍 的 是 通过 NWDS 提供 的 Web 服务 的 创建 向 导 快 速 
创建 Web 服务 的 方法 ， 并 且 服 务 端 也 有 针对 发 布 、 测 试 、 配 置 的 一 整套 环境 ， 使 得 Web 服 
务 的 使 用 更 加 地 灵活 和 方便 。 

2. Web Dynpro 5 Web 服务 

上 一 节 通 过 NWDS 创建 了 一 个 简单 的 Web 服务 ， 下 面 通过 一 个 开发 实例 重点 介绍 如 何 
在 Web Dynpro 中 通过 模型 的 创建 和 配置 进行 Web 服务 的 调用 。 

开发 实例 : 

1) 使 用 现 有 的 Web Dynpro 工程 ， 或 重新 创建 一 个 简单 工程 ， 如 图 3-334 所 示 。 本 例 
以 之 前 创建 的 mydynp03 为 例 。 

2) 右 击 “Models”， 在 弹出 的 快捷 菜单 中 选择 “Create Model”， 如 图 3-335 所 示 。 

3) 在 弹出 的 窗口 中 选择 对 应 的 模型 类 型 ， 这 里 选择 第 二 项 “Adaptive Web Service Mod- 
el”， 单 击 “Next” 按 钮 ， 如 图 3-336 所 示 。 


730 


la [& [LocalDevelopment] mydynp03 
4 ji Web Dynpro 
最 Applications 


Bel [ee J | 


B ce 


4 $ Components 
i> [LocalDevelopment] mydynp02 4 of) Dynp03_01Comp 


t [LocalDevelopment] mydynp03 


各 Component Controller 
veb-Dynpro 4 Local Component Interface 

> @ Dictionaries 只 Inherited Interfaces 

> @ Resources &@ Interface Controller 

4 && Interface Views 


| 3-334 Jil Web Dynpro 项目 目录 图 3-335 创建 模型 的 菜单 选择 
[IER New Moce = oa] 
| Selecta model type eS 4 
This wizard provides a guides for creating Web Dynpro models È z 


Available Models: | 


Adaptive RFC 2 Model This wizard guides you through creating an 


F Adaptive Web Service Model Adaptive Web Service Model 


{83 Enterprise JavaBean Model 
{83 Java Bean Model 
z Adaptive RFC Model - DEPRECATED 


@ so | re | (tk 


图 3-336 ”选择 模型 类 型 


1 


4) 输入 自 定 义 模型 名 称 ， 选 中 “Remote Location/File System” 单 选 按钮 作为 WSDL Hi 
述 文件 的 源 文 件 ， 单 击 “Next” 按 钮 ， 如 图 3-337 所 示 。 


New Model WE 
Import an Adaptive Web Service Model x 


Web Dynpro model created for Web services & & 


Model Name | PerinfoModel | 


Model Package com.sap.demo.mydynp03.wd.models.perinfomodel Browse... 
| 


Available WSDL Sources 
Enterprise Service Repository 


四 < Back Next | Enish | 


图 3-337 输入 模型 信息 


1 
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5) 输入 创建 的 Web 服务 对 应 的 WSDL 地 址 (在 Service Definitions 中 下 方 的 “WSDLS” 
页 签 中 可 以 看 到 ) ， 粘 贴 的 同时 开发 工具 会 立即 对 服务 做 连通 性 测试 。 测 试 成 功 后 ， 单 击 
“Next” 按 钮 ， 如 图 3-338 所 示 。 


[EE New Mode! rr ee eE 
WSDL URL Access S$ E 


URL: /PerlnfoWsService/PerInfoWs?wsdl&mode=ws_policy | Browse | 


Network Settings Preference Page 


图 3-338 ”输入 服务 地 址 


6) 接着 进行 运行 时 间 相 关 配 置 ， 选 中 “No service group configuration” 单 选 按钮 ， 不 需 
要 配置 服务 组 ， 单 击 “Next” 按 钮 ， 如 图 3-339 所 示 。 


|G New Model iit a e- E 


No service group configuration $ à 
& 


No service group configuration data will be created 


Service Interfaces | 
Namespace: http://myproject.com/ 
Endpoint Host: 10.128.143.18 


Service Interfaces: 


Name 

PerInfoWsLocal 
© Choose existing: | - | 
© Create new 
Package: LE | (default) Browse 
Name 10 128 143 18 
Description 10.128.143.18 
Create in Project: [LocalDevelopment] mydynp03 v 


Local Provider System: |_| 


Ly 


3-339 ”确认 服务 配置 
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7) 输入 逻辑 目的 地 名 称 ， 输 入 “MT_WS_PFRINFO_DEST” (常用 的 命名 规范 为 系统 名 
+ 服务 类 型 标识 + 服务 标识 + 目的 地 ， 根 据 实 际 系统 配置 进行 填写 ) ， 单 击 “Next” 按 钮 。 
此 处 MT 默认 为 系统 名 ， 服 务 类 型 为 Web Service， 服 务 标 识 或 描述 为 PERINFO ， 并 且 Meta- 
data 与 Execution 采用 同一 个 目的 ， 如 图 3-340 所 示 。 


ff) New Model -— ~= ~ 


Logical Destinations 


Define logical destinations for metadata retrieval and execution of the WSDL 
Define Logical Destinations 


© No logical destinations. Use WSDL URL for metadata retrieval and webservice q 


© Use destinations for metadata and execution. This allows you to configure the 


Default Metadata Destination MT_WS_PERINFO_DEST| 
Default Execution Destination | MT_WS_PERINFO_DEST 


@ You can change the WSDL URL after import by changing the corresponding md 


Al 3-340 配置 目的 


如 果 仅 采用 URL 做 为 源 数 据 的 目的 地 去 执行 ， 当 服务 的 地 址 或 端口 变化 后 ， 则 需要 重 
新 导入 模型 来 更 新 实际 开发 时 的 URL 远程 访问 地 址 。 然 而 实际 上 对 于 正在 运行 的 系统 来 讲 ， 
通过 修改 程序 的 方式 去 应 对 服务 端 接口 的 变化 显然 是 不 合理 的 ， 一 方面 是 带 来 了 较 大 的 维护 
开发 量 ， 另 外 一 方面 如 果 在 用 户 使 用 中 去 重新 布 署 程序 也 会 带 来 系统 运行 或 数据 丢失 的 风 
险 。SAP 使 用 服务 器 端 配置 的 目的 地 就 能 够 很 好 地 解决 这 个 问题 ， 当 运行 时 地 址 发 生变 化 
时 ， 直 接 修改 配置 内 容 的 WSDL 地 址 即 可 。 

8) 根据 需要 对 导入 的 模型 类 进行 重 命名 ， 跳 过 则 直接 单 击 “Next” 按 钮 ， 如 图 3-341 
所 示 。 


E New Model oo ~- yo 


Rename Model Classes 


You can rename the model classes by editing the “Model Class Name” column. 
The names must only consist of the characters a..z, AZ 0.9, and _ and must not began with or 0.9. 


(Enabled only if model classes have been renamed) 


| Actual Model Class Name Proposed Model Class Name 
E hetpe//myprojectcomy 
È hetpe//sap.com/tc/webdynpro/model/webse 


KI 3-341 确认 导入 内 容 


9) 在 弹出 的 对 话 框 中 ,可 以 看 到 导入 日 志 ， 也 就 是 看 到 对 应 Web 服务 接口 在 Web 
a Ne Wn oe Bm Lp eh i 
应 结构 ， 请 求 结构 中 包含 一 个 参数 为 Perld (方法 的 输入 参数 名 ) ， 响 应 的 结构 中 包含 一 个 
pes Return (方法 返回 String 类 型 的 数据 ， 系 统 默 认命 名 为 Return), Ai “Finish” Fn 

完成 模型 的 导入 配置 ， 如 图 3-342 所 示 。 
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10) 完成 配置 后 ， 就 可 以 在 工程 的 目录 中 看 到 对 应 导入 的 模型 以 及 模型 类 结构 ， 


Al 3-343 所 示 。 


FB New Model == 


| 
| Import Log 


Detailed description of the model import status 


Å? PerinfoModel 
4 G+ GetPerName 
Y Perid 
a Å» GetPerNameResponse 
RD, Return 
+ Request_GetPerName 
如 GetPerName 
#, Response 
4 @) Response_GetPerName 
到 GetPerNameResponse 


图 3-342 导入 日 志 查 看 


区 [LocalDevelopment] mydynp03 
a $ Web Dynpro 
E Applications 


4 Ar PerInfoModel 
4 & | Model Classes 
Ê GetPerName 
Ê GetPerNameResponse 


4 ĝ Request_GetPerName 
2 GetPerName 
@ Response 

4 ê Response_GetPerName 
@ GetPerNameResponse 


a) Component Intertaces 
«& Components 

@ Dictionaries 

Resources 


3-343 ”导入 后 的 效果 


11) 在 导入 模型 完成 之 后 ， 需 要 创建 对 模型 接口 的 调用 ， 即 创建 自 定义 控制 器 。 


首先 需要 添加 对 导入 模型 的 引用 : 右 击 组 件 中 的 “Used Models” , 


选择 “Add”， 如 图 3-344 所 示 。 


由 于 之 前 的 步骤 中 导入 的 模型 是 整个 Web Dynpro 工程 可 
以 使 用 的 ， 只 有 在 需要 使 用 的 组 件 中 添加 特定 模型 的 引用 ， 才 


能 在 组 件 中 进行 模型 接口 的 调用 。 


12) 在 弹出 的 对 话 框 中 选择 之 前 导入 的 模型 ， 单 击 “OK” 


按钮 ， 如 图 3-345 所 示 。 


如 


在 弹出 的 快捷 菜单 中 


@ Implemented Interfaces 
围 sie Pool 


eed 


H Views 


Compare Metadata 


图 3-344 添加 使 用 模型 


13) 添加 引用 之 后 ， 需 要 创建 一 个 自 定义 控 制 需 。 在 组 件 中 右 击 “Custom Controller” , 


在 弹出 的 快捷 菜单 中 选择 “Apply Template” , 


Add Used Models EL 


Select models: 


如 图 3-346 所 示 。 


| Select all || Deselect All 


O) | OK | | Cancel 


图 3-345 选择 模型 


4 <j Dynp03_01Comp 
¢@ Component Controller 


[a] Local Companen Interface 
$a Custom Coni 
@ Implemente 
E] Message Po 

4 @ Used Mode 
Qa PerinfoM 

«i Used Comp 

4 Views 
i] Dynp03. 

4 于 Windows 


ee Custom Serra 
Paste 


Compare Metadata 


Development Component 


Remove from Context Ctrl+ 


图 3-346 ”应 用 模板 的 菜单 选择 


14) 选择 “Service Controller” 服务 控 制 器 ， 单 击 “Next” 按 钮 ， 如 图 3-347 所 示 。 
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Apply Template 


Select Template 


Creates or configures a controller in the component 


Template Instance Name Service Controller 


Available Templates: 


Creates or configures a 
component 


controller in the 


WR] 


3-347 ”选择 模板 类 型 


15) 选择 之 前 导入 的 “PerInfoModel” 模 型 的 请 求 方 法 ， 单 击 “Next” 按 钮 ， 如 


图 3-348 所 示 。 


Apply Template 


| © x] 


Select an Executable Model Class 


The list of models is filtered. Supported model types are Adaptive 
RFC1, Adaptive RFC2, WebService, Adaptive WebService & __ 


Controller PerlnfoModelController 


PerInfoModel 


a 4 PerInfoModel 


ý Request_GetPerName 


© 
A 
lco 
a 
z 
m 
v 


器 


3-348 ”选择 对 应 的 模型 


16) 对 模型 字段 自动 生成 的 自 定义 控制 器 中 的 上 下 文 进行 具体 配置 ， 可 以 选择 所 有 字 


段 也 可 以 选择 部 分 字段 进行 创建 。 仔 细 分 析 可 以 看 到 , “Request_* ”作为 根 


结 点 ， 该 结 点 


下 面 的 “Response” 为 方法 返回 生成 的 响应 数据 结构 ， 与 “Response” 同 级 的 为 方法 输入 生 
成 数据 结构 ， 因 此 不 管 是 赋值 还 是 解析 ， 都 是 对 “Request_* ”下 面 数据 节点 的 操作 。 在 本 
例 中 ， 选 中 所 有 的 结 点 作为 自 定义 控制 器 中 的 上 下 文 ， 并 同时 完成 映射 配置 ， 随 后 单 击 
“Next” 按 钮 ， 如 图 3-349 所 示 。 

其 实在 这 一 步 配置 中 ， 与 之 前 视图 和 控制 器 的 上 下 文 映射 非常 相似 ， 在 这 里 完成 的 则 是 
自 定义 控制 占 的 上 下 文 与 导入 模型 的 数据 结构 进行 映射 。 

17) 默认 可 以 同时 创建 模型 的 执行 方法 ， 即 触发 接口 调用 ,输入 方法 名 称 ， 随 后 单 击 
“Finish” 按 钮 ， 如 图 3-350 所 示 。 
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Ee Apply Template Tov" Erm 


Model Binding 


Select the context elements you want to bind. Rename them by clicking the corresponding item in the 
list on the right. 


4 HO Context Name Model Class or... Model ... 
4 回回 Request_GetPerName [)GetPerN... GetPerNameRes... GetPer... 


V] (5) GetPerName 


4 (VP) Response 


> MIA GetPerNameResponse 


B Return Return 


Resolve bindings according to context element name. Existing bindings will be replaced 


a a 


Automatically resolve name clashes 


© | < Back | Next > | Einish Cancel 


P 
ww 
is 
省 
S 
Ss 
得 
型 
cs 
Tr 


Apply Template 


Specify Method for Model Execution 


Enter the name for the method if the model has to be executed 


V] Generate method for model execution 


3-350 ”输入 方法 名 称 


18) 完成 配置 后 ， 记 得 保存 所 有 修改 ， 检 查 编译 错误 ， 如 图 3-351 所 示 。 完 成 了 自 定 
义 控 制 器 的 创建 ， 在 组 件 的 模型 编辑 器 中 看 到 ， 增 加 了 自 定 义 控 制 器 和 导入 模型 两 个 对 象 ， 
同时 它们 之 间 也 已 经 完成 了 映射 配置 。 


® Models | 
J perinfoModel 
[sf] Component Interfaces 


Ly 


Dynp03_01 


Component 
Controller 
& 


$ Components 
喝 Dynp03_01Comp 
DÈ Component Controller 
Local Component Interface 


$e om Controlle | 
sae 
@ Implemented Interfaces â RA 
国 Message Pool 
@, Used Models 

@, PerInfoModel 
«i Used Components 
H Views 

Tj Dynp03_01Comp_01View 
Windows 


CompInt... 


m 


yo 


3-351 SERA A RA 


19) 接着 需要 从 视图 中 对 接口 进行 调用 。 首 移 将 自 定 义 控 制 器 的 方法 封装 至 组 件 控制 
器 中 ， 通 过 数据 链接 添加 组 件 控 制 咒 对 自 定 义 控 制 避 的 引用 ， 如 图 3-352 所 示 。 
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20) 将 两 个 控制 器 的 上 下 文 进 行 映 射 ， 如 图 3-353 所 示 。 


$ 2 Context Mapping - =- ol ~ ernim] 
Component = Dynp03_01 
Controller CompInt... Select the context elements to map 


Drag from right to left to create and map a new element in the left tree. 
Drag from left to right to map an existing element. 


Dynp03_01Comp PerinfoModelController | 


PerInfoMo © Context 4 © Context 


delContr... 
â 回 GetPerName — a O Ws ae 
B Perld Cn “a [$] GetPerName 
E GetPerNameResponse = |— | 一 一 下 一 - B® Perld 


a Un 4 Response 

p 
n aE, a [$] GetPerNameRe 
EAPOL EEEREN, B Return 


aperInfoMo 
dd 


K 3-352 引用 关系 图 3-353 上下文 映射 关系 


21) 在 组 件 控 制 器 新 增 自 定义 方法 “executePerInfo”， 添 加 后 保存 修改 ， 如 图 3-354 
TAN o 
22) 保存 之 后 ， 双 击 方法 进入 代码 编辑 器 ， 添 加 以 下 代码 : 


// 获 取 自 定义 控制 器 的 实例 ,并 执行 自 定义 控制 器 中 的 “execute ”方法 
wdThis. wdGetPerInfoModelControllerController( ). executeGetPerName( ) ; 


23) 将 视图 的 上 下 文 与 组 件 控制 器 上 下 文 进行 映射 ， 如 图 3-355 所 示 。 
iz Context Mapping E = 一 一 一 一 


Selectthe context elements to map 


Drag from right to left to create and map a new element in the left tree. 
Drag from left to right to map an existing element. 


cĉ Component Controller Dynp03.01Comp_01View Dynp03_01Comp 

General 4 © Context © Context 

References Fa 4 [O] GetPerName sf - A GetPerName 

a ing Perld sasacasesensssasoussunsnsasessnssonsssssedon ose ing Perld 

aw | type filter text i 4 C GetPerNameResponse "| pp C) GetPerNameResponse 
eel &} executePerInfo - void B Return @ Return 

vent Handlers 

Events 


图 3-354 添加 自 定义 方法 图 3-355 添加 上 下 文 映射 


24) 打开 “Dynp03_01Comp_01View” 视 图 ， 在 “Outline” 元 素 清单 中 右 击 根 结 点 ， 选 
FE “Apply Template”， 如 图 3-356 所 示 ， 选 择 按 钮 类 型 并 单 击 “Next” 按 钮 至 结 
25) 完成 按钮 创建 后 ,保存 所 做 的 修改 。 随 后 双击 按钮 进入 代码 编辑 器 ， 如 图 3-357 
所 示 。 
在 按钮 的 事件 处 理 器 方法 中 添加 赋值 与 打印 代码 : 
wdContext. nodeGetPerName( ). currentGetPerNameElement( ). setPerId( "0010000" ) ;赋值 请 求 参 数 
wdThis. wdGetDynp03_01CompController( ). executePerInfo( ) ;// 执 行 调 用 Web Service 接口 的 方法 
String returnl = wdContext. nodeCetPerNameResponse( ) . 


currentGetPerNameResponseElement( ). getReturn( ) ;人 /获取 返回 参数 
wdComponentAPI. getMessageManager( ). reportSuccess( return1 ) ;打印 返回 值 
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Apply Template Ermy 


Select Template 


Creates a button in the view 


Template Instance Name Action Button 


Available Templates: 


| E3 Action Button Creates a button in the view 
EJ Form 
B Table | 

L J 


图 3-356 ”选择 模板 类 型 


CÈ Dynp03_01Comp 内 Dynp03_01Comp.java [| Dynp03_01Comp_01View i 
e Filter Text 
InvokeWs 
© History 
P ToolBarButton 
Ri InputField 
T Label 


3-357 ”创建 按钮 后 的 效 身 
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26) 至 此 ， 所 有 配置 和 代码 工作 都 已 完成 ， 保 存 所 有 修改 并 编译 部 署 至 服务 器 ， 如 网 3-358 
所 示 。 


27) 单 击 “InvokeWs” 按 钮 后 ， 就 能 在 页 面 下 方 看 到 Web 服务 返回 的 姓名 信息 ， 如 
图 3-359 所 示 。 


Invokes 


KI 3-358 ”运行 效果 BI 3-359 单 击 按钮 效果 


关于 运行 时 的 目标 模板 配置 说 明 如 下 。 

上 述 创建 模 型 时 ， 在 配置 本 地 目标 的 步骤 输入 了 “MT_ WS_ PERINFO_ DEST”, xS 
目标 是 需要 在 服务 器 端 提 前 进行 配置 的 ， 程序 运行 时 模型 的 元 数据 运行 程序 也 会 通过 配置 的 
目标 查找 对 应 的 接口 、 传 递 参 数 以 及 获取 返回 信息 。 

1) 使 用 管理 员 账 户 登录 到 服务 器 NWA EG, M “SOA” — “Technical Configura- 
tion” 命令 ， 随 后 单 击 “Destination Template Management” 目标 模板 管理 链接 。 

2) 进入 页 面 后 ， 单 击 “New” 按 钮 ， 新 建 一 个 目标 输入 的 信息 ， 如 图 3-360 所 示 。 

3) 单 击 “Next” 按 钮 ， 在 下 一 步 中 输入 服务 验证 信息 。 由 于 之 前 在 创建 Web Service 时 
并 未 添加 验证 ， 因 此 此 处 选择 “None”， 如 图 3-361 所 示 。 
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Destination Template Management: Destination Templates 


Favorites, RewledLinky, GoTo, Support iaio 


To Contouraton | 


New Destination 


m 2 
rr- 
General 


[E Previous | | Next >] |, Finwn | [Canoe 


Enter a name for the logical port 
WSL 了 | 
WT WS_FERNFO_DEST ] 


ParnfoWaService/ParhfoWs?wadibrodesws_pokey 
Socket Timeout (n msecends 60,000 Ñ| 

System 
Syatom Kame: | 


Hostname | 


BS 


3-360 输入 目标 信息 


Destination Template Management: Destination Templates 


Favertes, Related Links, GoTo, Support nfo 


SSL Server Certificates 


© gnore server certificates 
©) Accept certificates in keystore view CTCV ew 


Message Security 

[] Use WS-Secure Conversation (Version: February 2005) i 
Outgoing Request | Incoming Response | 
[Add Encryption [C Require Encryption 
(Add Signature [C Require Signature 


Delais 


KI 3-361 ”选择 验证 方式 


4) 完成 所 有 信息 填写 后 ， 单 击 “Finish” 按 钮 即 可 。 

3. Java 与 Web 服务 

Java 访问 Web 服务 的 方式 有 很 多 ， 目 前 比较 成 熟 的 框架 包括 有 XFire, AJAX 等 。 传 统 
Java 工程 通过 引入 这 些 框架 对 应 的 第 三 方 Jar 包 以 及 它们 提供 的 API 便 可 以 完成 对 Web 服务 
的 调用 ， 但 前 提 是 需要 自己 编写 调用 逻辑 。 在 实际 的 项 目 开 发 中 ，Web 服务 的 接口 往往 是 
比较 复杂 的 ， 尤 其 对 于 内 套 的 集合 结构 类 型 ， 客 户 端 在 不 管 构 造 赋值 请 求 数据 还 是 解析 响应 
都 是 一 个 非常 复杂 而 量 大 的 过 程 ， 这 样 无 疑 降低 了 开发 者 的 开发 效率 ， 同 时 也 增加 了 接口 双 
方 调试 的 难度 。 而 Web Dynpro 在 调用 Web 服务 时 自动 生成 本 地 客户 端 代 理 ， 并 且 提 供 的 接 
口 报 文 日 志方 便 在 接口 调试 时 做 数据 跟踪 ， 以 及 运行 时 的 配置 来 应 对 服务 端 地 址 或 端口 变化 
的 情况 。 
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开发 实例 : 


1) 切换 到 DI 视图 ， 右 击 自 定义 的 SC 目录 ， 选 择 “Development Component”， 如 图 3-362 


所 示 。 


2) 在 弹出 的 窗口 中 选择 对 应 的 EJB 类 型 ， 单 击 “Next” 按 钮 ， 如 图 3-363 所 示 。 


mr 
New » 
Show In » 


È Build Cortained Local OCs 
X Delete 


ùs Import 
a3 Export. 

View SC Description 
Gh Release 


F Search for OC. 
Refresh 


图 3-362 ”创建 姑 


Development Configuration 
MyComponents 

Inne MyComponents 

demo.sap.com 


MyComponents 


Ff 发 组 件 的 菜单 选择 


局 New Development Component (Project) =i a 


New Development Component 


Select Development Component Type. 


Type: 


a OF sap.com 
加 Composite Application 
> [ Content 
DC Build 
@ Dictionary 
Er Enterprise Portal 
Á External Library 
i Java 
4 @ Java EE 
(@)] Enterprise Application 
图 Web Module 
Process Composer 
Rules Composer 
$ Service Composer 
Service Group Configuration 


Software Logistics 
Text 


BK AEA 8 


| oh 


m 


Supported DC Type 


| | Cancel 


| 3-363 


3) 输入 自 定义 DC MWA, A “Finish” IH, WEI 3-364 所 示 。 


选择 项 目 类 型 


Locati 


4) 创建 工程 完毕 后 ， 展 开工 程 ， 右 击 “ejbModule” 中 的 “META - INF”， 并 选择 


Project Name: 


Java EE Version: 


Directory: 


on 


© Create project in the workspace 


JPA Settings 


回 Use JPA 


WR] 


LocalDevelopment~myejb05~demo.sap.com 


Create project at external location 


D:\n730_wk_nbk01,jdi\LocalDevelopment\DCs\demo.sap.com\myejb05\_comp | | Browse 


3-364 选择 编译 版 本 


“Import” 导 入 ， 导 入 类 型 选择 “Web services” 中 的 “WSDL”， 单 击 “Next” 按 钮 ， 如 


图 3-365 所 示 。 


5) 描述 文件 源 选 择 “Remote Location/File System” 单 选 按钮 ， 如 图 3-366 所 示 ， 单 击 


e Next” 按钮 
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4 © Web services 
Š Web Service 


Available WSDL Sources 


D Enterprise Service Repository 


Æ WSDL 
B, WSIL © Remote Location / File System 
Æ XSD 5 Services Registry 


图 3-365 选择 服务 类 型 Al3-366 选择 源 文件 类 型 


6) 输入 创建 的 Web Service WSDL 地 址 ， 该 地 址 通过 服务 器 中 NWA 管理 员 平 台 的 “Serv- 
ice Definitions” 服务 目 的 地 进行 查看 , É “Finish” 按钮 ， 如 图 3-367 所 示 。 


URL: /PerInfoWsService/PerInfoWs?wsdl&mode=ws_policy Browse 


Network Settings Preference Page 


器 


3-367 ”输入 服务 地 址 


7) 完成 WSDL 文件 的 导入 之 后 ， 可 以 看 到 在 文件 夹 中 已 导入 了 对 应 的 文件 ， 如 
图 3-368 所 示 。 


4  ejbModule 
4 | META-INF 


四 ejb-j2ee-engine.xml 

国 MANIFEST.MF 

Æ rootwsdl_importedwsdl_1_PerInfoWsService.wsdl 
Æ rootwsdl_importedwsdl_2_PerInfoWsService.wsdl 
Æ rootwsdl_PerInfoWsService.wsdl 


WR] 


3-368 ”导入 后 的 效果 


8) 右 击 导入 的 rootwsdl_PerlnfoWsService. wsdl 文件 ， 选 择 “Web Services” — “Generate 
Client”， 如 图 3-369 所 示 。 


Web Services » Test with Web Services Explorer 
Service Mocking 上 Publish WSDL file 

Development Component > Generate Java bean skeleton 
Source » Generate Client 

WikiText » Generate WSIL 


器 


3-369 创建 客户 端的 菜单 选择 


9) 客户 端的 配置 级 别 选 择 “Develop Client” 开 发 级 别 客户 端 ， 随 后 按 默认 配置 单 击 
“Next” 按 钮 ， 如 图 3-370 所 示 。 


fi 


Service definition: /LocalDevelopment~myejb05~demo.sap.com/ejbModule/META-INF/rootwsdl_P: v | Browse 


Client type: [Java Proxy z 


Develop client j 


Server: SAP Server 


Oo Web service runtime: SAP NetWeaver 


Client project: LocalDevelopment~myejb05~demo.sap.com 


二 Client EAR project: LocalDevelopment~myear01~demo.sap.com 


F] Monitor the Web service 


T] Do not show me this dialog box again. 


WR] 


3-370 配置 服务 级 别 


14] 


10) 客户 端 生 成 后 ， 就 能 在 对 应 的 包 中 看 到 自动 生成 的 代理 类 ， 如 图 3-371 所 示 。 
11) 调用 对 应 的 Web 服务 ， 新 建 Session Bean， 并 填写 相关 的 包 名 和 类 名 ， 如 图 3-372 
所 示 。 


EJB project: | LocalDevelopment~myejb05~demo.sap.com ’ | 


Source folder: /LocalDevelopment~myejb05~demo.sap.com/ejbModule | Browse... 


Java package: com.myproject.inter Browse... 


回回 回 


4 @ ejbModule 
4 册 com.myproject 
> D 


> D 


GetperNameJjava 
GetperNameResponsejava 
b D ObjectFactoryjava 
package-info.java 


PerInfoWsLocal,java 


Al 3-371 自动 生成 的 类 文 伯 


Class name: PerInfoUtil 


Superclass: Browse... 


State type: Stateless 区 | 


Create business interface 


一 


Remote | com. myprojectinter rperinfoUtilRemote 


PerInfoWsServicejjava 加 Local com.myproject.inter.PerInfoUtilLocall 


证 


图 3-372 输入 项 目 信 息 


12) 接口 中 声明 获取 用 户 名 的 “getPerName” 方 法 ， 代 码 示 例如 下 : 


public interface PerInfoUtlLocal | 
public java. lang. String getPerName( String perld) ; 


| 


13) 切换 到 Session Bean， 定 义 导 入 的 Service 引用 ， 过 获取 Servicelnterface 实现 该 方 
法 ， 代 码 示例 如 下 : 


package com. myproject. inter; 


import javax. ejb. Stateless; 
import javax. xml. ws. WebServiceRef; 


import com. myproject. PerlnfoWsLocal ; 
import com. myproject. PerlnfoWsService ; 


JEg 
* Session Bean implementation class PerInfoUtil 
*/ 
@ Stateless 
public class PerInfoUtil implements PerInfoUtilLocal | 
@ WebServiceRef(name = " PerlnfoWsService" ) 
PerlnfoWsService service; 


/* x 

* Default constructor. 
*/ 

public PerInfoUtil( ) | 
// TODO Auto - generated constructor stub 

| 

@ Override 

public String getPerName( String perld) | 
// TODO Auto - generated method stub 
PerInfoWsLocal perInfoWsPort = service. getPerInfoWsPort( ) ; 
return perlnfoWsPort. getPerName( perld) ; 
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14) 保存 所 有 修改 即 完成 了 Web 服务 调用 的 EIB 实例 ， 其 他 工程 通过 直接 调用 该 EJB 
来 访问 创建 的 Web 服务 ， 或 者 可 以 将 EJB 再 次 发 布 Web Service 并 对 客户 端 程序 做 测试 。 

4. 消费 端 服 务 配置 

新 建 的 EJB 工程 通过 EAR 项 目 部 署 到 SAP Java 应 用 服务 器 后 ， 能 够 在 NWA 中 消费 端 
服务 功能 中 查找 该 客户 端 代理 。 

1) 使 用 管理 员 账 号 登录 NWA 平台 ， 单 击 “Configuration” 一 “Connectivity” 命 令 ， 单 
击 “Single Service Administration” 链接 并 找到 “Consumer Proxies” 消 费 者 代理 配置 ， 如 
图 3-373 所 示 。 


图 3-373 查看 服务 列表 
2) 在 “Configuration” 配 置 页 签 中 可 以 对 Web 服务 进行 详细 配置 ， 如 图 3-374 所 示 。 


| New || Delete | | LSetas Default 


ee 


图 3-374 ”代理 的 逻辑 端口 


3) 配置 明细 包含 代理 类 调用 的 Web Service 地 址 以 及 Web 服务 的 安全 认证 等 ， 如 
图 3-375 所 示 。 


Logical Port Name: 
Web Service Endpoint URL: | http://10.128.143.18:50100/P 


图 3-375 逻辑 端口 的 详细 配置 


4) 单 击 “Edit” 编 辑 “Security” 安 全 信息 ， 输 入 访问 Web Service 时 输入 的 用 户 认 证 
信息 ’ 如 网 3-376 所 示 。 
在 Web 服务 接口 保持 不 变 ， 而 WSDL 地 址 发 生变 更 时 ，Consumer Service 是 对 应 于 Java 


143 


oe 的 服务 端 配 置 ， 通 过 后 台 修 改 这 些 参数 可 以 灵活 地 应 对 接口 服务 端 服 务 地 址 或 认证 信 
的 变动 ， 并 不 需要 做 任何 设计 时 的 修改 。 


y General Messaging Web Service Addressing Transport Settings 
Authentication SSL Server Certificates 
Authentication: HTTP Authentication v (©) Ignore Server Certificates 
© User ID/Password (Basic) © Accept Certificates in Keystore View| CTCView 
O User ID/Password (Digest) - 
OX509 Client Certificate Message Security | 
= ee et 口 Use WS-Secure Conversation (Version: February 2005) 
WiL Assertion i = 
Details Off Quo Remost beeing Response, 
[C Add Encryption [C Require Encryption 
Details | [C Add Signature [C Require Signature 
User ID/Password [=| [ Details ] 
User ID: fae ae S| 
Password —— 


Confirm Password: fs 
图 3-376 安全 配置 


3.7.4 EJB 模型 实例 


与 通常 的 JavaBean 不 同 ，EJB 具备 可 分 布 计算 的 特性 。EJB 发 布 到 服务 器 后 可 以 通过 
INDI 访问 对 应 的 EJB 服务 。 [project Explorer 2a ES] al 
由 于 之 前 在 创建 Web Service 时 已 经 建立 了 名 为 Per- ee ea 


> #3 [LocalDevelopment] mydynp02 


InfoWs 的 EJB， 这 里 不 再 重复 创建 的 步骤， 直接 引用 该 > E [LocalDevelopment] mydynp03 
a b a5 [LocalDevelopment] myear01 
EJB， 如 图 3-377 所 示 。 


4 [$5 [LocalDevelopment] myejb01| 


开发 实例 > Deployment Descriptor: [Local] 
> $ > Æ JAX-WS Web Services 


1) 使 用 现 有 的 Web Dynpro 工程 ， 或 重新 创建 一 个 简 4 @ ejbModule 


单 工 程 。 本 例 以 之 前 创建 的 mydynp03 为 例 ， 如 图 3-378 
所 示 6 > 国 PerInfoWsLocal java 


> @ META-INF 
2) 右 击 “Models”， 在 弹出 的 快捷 菜单 中 选择 “Create a 
Model”， 如 图 3-379 所 示 。 4a- 原 项 目 示 


u © [LocalDevelopment] mydynp03 
a jp Web Dynpro 
E Applications 


S Tma | 


b E [LocalDevelopment] ERR 4 «i Components 


+ tte 
mpi b-Ery d Component Controller 
b Lape Dictionaries 4 [A Local Component Interface 
® Inherited Interfaces 
&@ Interface Controller 
4 B Interface Views 


| 3-378 Jil Web Dynpro 项 目 目录 3-379 创建 模型 的 菜单 


> & Resources 


3) 在 弹出 的 窗口 中 选择 对 应 的 模型 类 型 ， 这 里 选择 第 三 项 “Enterprise JavaBean Mod- 
el”， 单 击 “Next” 按 钮 ， 如 图 3-380 所 示 。 
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= 
|This wizard guides you through creating an 
|Enterprise JavaBean Model. 


P 
§3 Java Bean Model 
® Adaptive RFC Model - DEPRECATED 


WR] 


3-380 ”选择 模型 类 型 


4) 输入 导入 的 模型 名 称 ， 并 且 添 加 依赖 EJB 所 在 的 DC (DC 类 型 为 EAR)， 单 击 
“Next” 按 钮 ， 如 图 3-381 所 示 。 


Import an Enterprise JavaBean Model op 
Create a Web Dynpro model for Enterprise JavaBeans Š 
Model Name ”PerinfModel 
Model Package com.sap.demo.mydynp03.wd.models.perinfmodel a i Browse.. 


Select Enterprise Application 


Enterprise Application a A 


3-381 输入 模型 信 ， 


证 


注 : EAR 工程 public parts 需要 添加 对 EJB 的 引用 (添加 DC 依赖 过 程 可 参考 3.6.3 


P)o 
5) 选中 对 应 需要 导入 的 EJB， 并 以 默认 配置 完成 后 续 向 导 ， 如 图 3-382 所 示 。 


Available Enterprise JavaBean od 
oS 


Select the required Enterprise Beans and interfaces. When you select the interface on 
the left, the system displays the corresponding methods in the interface on the right. 


Select Methods for Import 


4 WẸ Session Beans W] @ String getPerName (String) 
4 EEs PerInfoWs 
4 F| Local Interfaces 
Vv |G PerInfoWsLocal | 


图 3-382 ”选择 方法 


6) 创建 自 定 义 控制 器 ， 且 完成 其 上 下 文 与 模型 的 映射 ， 如 图 3-383 所 示 。 

7) 创建 视图 及 按钮 (或 直接 使 用 已 存在 按钮 ) ， 并 在 代码 编辑 中 添加 对 自 定义 控制 器 
中 执行 方法 的 调用 ， 如 图 3-384 所 示 (具体 过 程 请 参考 3. 6. 3 节 ) 。 

8) 至 此 ， 所 有 配置 和 代码 工作 都 已 完成 ， 保 存 所 有 修改 并 编译 部 署 至 服务 器 ， 如 
图 3-385 所 示 。 

9) 单 击 按钮 后 ， 就 能 在 页 面 下 方 看 到 EJB 模型 返回 的 姓名 信息 ， 如 图 3-386 所 示 。 
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eee mete ca] Dynp03_01Comp 


A 
Dynp03_01 
Comp_0... 

& 


Dynp03_01 
Comp_0... 
& 


Dynp03_01 
Comp_0... 


国 
& 


Component 
Controller 
& 


Dynp03_01 
Compint... 


2; 
PerInfoMo 
delContr... 
& 


2. 
FindPersMo 
delContr... 
& 


@yPerInfoMo 
dd 


@aFindPersMo 
dd 


WR] 


3-383 ”添加 上 下 文 映 射 后 的 效果 


Dynp03_01 
Comp_0.… 


日 
& 


Dynp03_01 
Compint... 


ay 
PerInfoMo 
delContr.- 


PerInfMod 
elController 


4 
FindPersMo 
delContr... 

& 


@aFindPersMo 
dd 


2 
> 
& 


3-384 ”添加 方法 调用 后 效果 


= p 
[Bess | 


图 3-385 ”运行 效果 图 3-386 单 击 按钮 后 的 效 呈 
3.7.5 应 用 场景 贴 士 


1， 公 共 模 型 
根据 项 目的 需求 ， 接 口 的 数量 是 有 限 的 ， 但 往往 多 个 功能 都 会 访问 同一 个 接口 。 例 如 ， 
通过 登录 ID 从 ECC 端 获 取 该 人 员 的 HR 人 员 信 息 ， 这 属于 一 个 公共 接口 ， 所 有 的 子 应 用 在 
初始 化 时 都 会 通过 调用 该 接口 来 显示 登录 的 用 户 信 息 。 这 样 就 会 导致 每 一 个 功能 开发 人 员 都 
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要 创建 针对 同一 接口 的 客户 端 代理 (Model) ， 带 来 了 较 多 不 必要 的 开发 量 ， 同 时 导致 后 期 
接口 结构 变化 不 易于 维护 。 此 时 可 以 通过 在 公用 DC 中 创建 公共 模型 的 形式 ， 让 所 有 的 开发 
人 员 统 一 使 用 同一 模型 去 调用 接口 ， 这 样 一 方面 降低 了 各 自 单独 创建 模型 带 来 的 工作 量 ， 另 
一 方面 即使 后 期 接口 发 生变 化 ， 也 只 需要 修改 一 个 模型 ， 方 便 了 管理 和 维护 。 

可 能 一 些 人 会 提 到 ， 开 发 人 员 是 采用 了 同一 个 模型 ， 但 却 分 别 创建 了 很 多 自 定 义 控 制 
器 。 实 际 上 正如 上 面 提 到 的 ， 如 果 该 接口 确实 是 公共 接口 ， 那 就 应 该 在 公共 DC 中 对 接口 进 
行 封装 ， 具体 的 方法 就 是 在 公共 DC 的 组 件 中 创建 自 定义 控制 器 以 及 在 它 的 组 件 控制 器 中 封 
装 调用 接口 的 方法 ， 并 最 终 通 过 接口 控制 器 和 开发 组 件 的 公共 部 分 声明 给 外 部 DC 调用 。 这 
样 实际 上 就 是 进一步 地 减少 了 功能 开发 人 员 接 口 调用 的 开发 ， 省 去 了 创建 自 定义 控制 器 的 过 
程 ， 同 时 可 以 通过 直接 访问 公共 DC 组 件 的 方法 来 实现 对 外 部 系统 服务 的 调用 。 

2. 接口 变更 

系统 间 调 用 接口 时 ， 往 往 会 因为 初期 双方 沟通 、 调 研 不 足 或 没有 合理 预 留 有效 字段 造成 
接口 的 输入 /输出 参数 不 能 够 满足 实际 业务 需求 ， 这 样 会 导致 频繁 的 接口 结构 变化 ， 进 而 影 
响 到 客户 端 接口 的 访问 。 实 际 上 ， 服 务 端 接口 结构 的 变化 对 客户 端 接口 调用 来 讲 影响 是 很 大 
的 ， 有 时 候 甚 至 会 导致 整个 接口 调用 的 重新 开发 ， 由 此 会 带 来 较 大 的 重复 工作 量 。 实 际 的 项 
目 开发 中 应 该 从 前 期 的 接口 设计 着 手 ， 尽 可 能 地 让 接口 满足 多 样 的 需求 ， 如 充分 地 了 解 需求 
或 预 留 一 些 备用 字段 等 ， 同 时 还 应 该 做 好 对 接口 结构 变化 的 应 对 处 理 。Web Dynpro 的 开发 
工具 提供 了 “Reimport” 重 新 导入 模型 的 操作 来 使 客户 端的 代理 类 与 服务 端 同步 ， 自 定义 控 
制 絮 中 的 上 下 文 也 可 以 通过 修改 上 下 文 映射 使 上 下 文 结构 与 重 导 入 的 模型 接口 结构 保持 
一 致 : 


3.8 应 用 程序 


从 之 前 不 同 的 Web Dynpro 实例 中 可 以 看 到 ， 应 用 程序 是 最 终 Web Dynpro 项 目 运行 的 实 
体 ， 也 是 服务 器 端 实际 挂 载 和 运行 的 对 象 。 

以 之 前 实例 中 的 应 用 程序 为 例 ， 双 击 打开 其 中 的 应 用 程序 ， 接 着 来 了 解 一 下 Web Dyn- 
pro 应 用 程序 的 一 些 具体 属性 ， 这 其 中 包括 了 基本 属性 (General) 、 应 用 程序 引用 ( Applica- 
tion References) 和 应 用 程序 属性 (Application Properties) 三 个 子 页 签 的 内 容 。 

D 在 基本 属性 子 页 签 中 ， 看 到 的 是 它 的 一 些 基 本 属性 ， 如 名 称 和 描述 等 内 容 ， 如 
图 3-387 所 示 。 


ly Overview 


Name _ com.sap.demo.mydynp03.wd.app.dynp03_01comp_Olapp.Dynp03_01Comp_01App 
~ Documentation: 


Displays documentation details 


Quick Information: 


Documentation: 


Al 3-387 应 用 程序 的 基本 信息 


2) 在 应 用 程序 引用 子 页 签 中 可 以 看 到 ， 应 用 程序 在 运行 时 默认 显示 的 实际 接口 视图 内 
容 ， 此 处 也 可 以 在 创建 应 用 完毕 后 根据 实际 需要 进行 调整 和 修改 ， 如 图 3-388 所 示 。 
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Displays the details of the launch 


Dynp03_01Comp - com.sap.demo.mydynp03.wd.comp.dynp03_01comp 


Dynp03_01Comp_01IntV 


Web Dynpro Component 


Interface View 


Startup Plug 


图 3-388 应 用 程序 的 引用 信息 


3) 在 应 用 程序 属性 子 页 签 中 ， 可 以 针对 应 用 程序 定义 一 些 特殊 的 参数 ， 如 是 否 需 要 权 
限 验证 、 过 期 时 间 等 ， 如 图 3-389 所 示 。 


v Application Properties 


Displays the application properties 


Name Type Description 
sap.authentication true Authentication mode 


图 3-389 应 用 的 属性 


4) 如 果 需 要 添加 参数 ， 则 单 击 “Add” 按 钮 就 可 以 进行 修改 ， 如 图 3-390 所 示 。 


Type 
@ Predefined 
© User defined 


Name | Browse 


图 3-390 添加 属性 


5) SAP 也 提供 了 许多 预定 义 的 应 用 程序 属性 ， 供 开发 人 员 进 行 配 置 和 使 用 ， 如 
图 3-391 所 示 。 


Select an application property 


Authentication (Authentication mode) 三 
DefaultLocale (Default locale for anonymous users) 


DomainRelaxation (Specifies whether domain relaxation is used when r| 


| ExpirationTime (The time in seconds, until a session without user respc 
iViewSplitting (Defines whether the application should be split into seve 


LogoffURL (URL to a page which is displayed after logging off) 
SuspendableApplication (Controls whether the application is suspenda -~ 


———— 3 
@ 


3-391 选择 属性 类 型 


人 说 
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第 4 章 用 户 界面 元 素 


对 于 一 般 的 开发 人 员 来 说 ， 代 码 是 一 个 程序 最 核心 的 部 分 ， 但 在 实际 项 目 中 ,不 论 是 产 
品 开发 还 是 二 次 开发 ， 单 元 测试 、 集 成 测试 、 压 力 测试 已 经 在 很 大 程度 上 完成 了 代码 功能 
分 的 验证 ， 而 应 用 程序 的 界面 (User Interface, Ul) 才 是 用 户 直 接 接触 的 部 分 ， 所 以 界面 实 
现 的 功能 、 布 局 设计 和 易 用 性 更 多 地 决定 了 实际 的 最 终 用 户 体 验 。Web Dynpro 提供 了 丰富 
的 界面 元 素 对 页 面 进行 “ 装 江 ”， 本 章 将 逐一 对 这 些 界 面 元 素 进行 介绍 ， 同 时 还 提供 具体 的 
开发 实例 。 


4.1 界面 元 素 介绍 


接触 过 网 页 开发 或 其 他 页 面 搭建 的 用 户 ， 应 该 经 常会 接触 到 “控件 ”或 者 “UI 控件 ” 
这 样 的 描述 ， 而 在 Web Dynpro 中 确切 的 叫 法 是 “用 户 界 面 元 素 ” 或 “UI 元素 ” (User Inter- 
face Element) 。 在 刚 开始 接触 Web Dynpro 开发 时 ， 可 能 会 觉得 界面 元 素 和 一 般 的 页 面 控 
件 非常 相似 ， 如 按钮 、 表 格 、 下 拉 列 表 等 ， 但 其 实 通过 实际 的 学 习 和 应 用 ， 就 会 发 现 
很 多 Web Dynpro 的 界面 元 素 不 只 是 一 个 简单 的 HTML 控件 ， 它 还 封装 相应 的 事件 并 作为 
接口 来 提供 一 些 功 能 。 例 如 ， 表 格 类 型 的 元 素 就 默认 绑 定 了 6 个 标准 事件 ， 如 图 4-1 
所 示 。 


General Property 


=o | 4 Events 
onColSelect 
onDrop 
onFilter 
onLeadSelect 
onSelect 
onSort 


EF 


Ilin 


图 4-1 表格 元 素 的 标准 


4. 1.1 元 素 的 添加 


在 Web Dynpro 中 ， 一 种 添加 UI 元 素 的 方法 是 打开 视图 的 布局 编辑 器 ， 直 接 从 编辑 器 的 
左 侧 将 UI 元素 拖 忠 至 视图 上 ， 当 鼠标 悬 停 在 UL 元 素 上 时 ， 会 有 对 应 元 素 的 一 个 简单 介绍 弹 
出 ， 如 图 4-2 所 示 。 男 一 种 添加 UI 元 素 的 方法 是 通过 左下 角 的 元 素 清 单列 表 (Outline 元 素 
大 纲 ) 。 清 单 是 当前 打开 视图 中 所 有 页 面 元 素 一 个 树 状 结构 的 体现 ， 也 清晰 地 展现 了 各 个 UI 
元 素 直 接 的 包含 或 者 并 列 关 系 ， 如 图 4-3 所 示 。 

右 击 任 一 个 容器 元 素 ， 如 右 击 “RootElement” 根 元 素 ， 弹 出 菜单 的 第 一 项 就 是 “Insert 
Child”， 在 弹出 的 对 话 框 中 即 可 创建 不 同 的 UI 元素 ， 如 图 4-4 所 示 。 
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<Type Filter Text> 


| Button( The Button UI element represents a push button. 


“ti LinkChq when the button is activated, event onAction is triggered. This 


== LinkToA 


event has no parameters, but an application may add constant 


parameters using event parameter mapping. 


av 


“F LinkTo! 


Select the UI element you want to create. You can also enter an ID for it 


4 |] RootElement 


m ToDynp01_PLO2_View 


&& Context Menus 


图 4-3 “Outline” 视 图 


Category 


Library 


UI Element 


[all] 

Action 
Complex 
Graphic 
Integration 
Layout 
Menu 
Selection 
Text 
Toolbar 


[All] 

Active Components 
Adobe 

Analytics 

Business Graphics 
Business Intelligence 
Calendar 

Mobile Add-Ons 
Office Integration 
Pattern Development 
Realtime Messaging 
Standard 


|Table 


E TabStrip 

TextEdit 

TextView 

@ TimedTrigger 
ToggleButton 

ras ToggleLink 

ToolBar 

=P ToolBarButton 

B ToolBarButtonChoice 

€F ToolBarDropDownBylndex 
t ToolBarDropDownByKey 
© ToolBarlnputField 
ToolBarLinkChoice 

3 ToolBarLinkToAction 


d 


ID Tablel 


| Documentation 


Data binding: 


Table represents a two-dimensional data set arranged in rows and columns. 


Atable gets its data from a context node Rows. 


e The number of table rows is given by the size of node Rows 


图 4-4 不 同 的 元 素 类 型 


在 图 4-4 中 共有 3 栏 ， 分 别 表示 分 类 目录 、 对 应 类 库 和 具体 UI 元素 选择 。 前 两 个 分 类 


的 选择 只 是 为 了 缩小 可 选 UI 元 素 ， 
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熟悉 各 个 对 象 之 后 直接 在 最 后 一 栏 通过 名 字 或 首 字母 快 
捷 键 进行 查找 即 可 。 中 间 的 “ID” 文 本 框 则 是 用 于 填写 创建 UL 元 素 的 唯一 标识 ， 默 认 情 况 


下 系统 对 于 重复 元 素 会 自动 进行 顺序 编号 ， 不 会 出 现 重复 的 标识 。 最 下 方 的 文档 说 明 是 对 所 
选择 的 UI 元 素 的 定义 和 简单 的 使 用 说 明 。 在 选择 对 应 的 UI 元素 后 ， 单 击 “OK” 按钮 即 可 
完成 一 个 UI 元 素 的 添加 。 

在 这 里 一 直 用 “添加 ”而 不 是 “创建 ”， 是 因为 对 于 这 种 图 形 化 的 开发 方式 ， 其 实 真正 
的 创建 过 程 是 由 开发 工具 在 拖 中 元素 或 单 击 菜单 的 过 程 中 自动 创建 的 。 


4.1.2 元 素 的 通用 属性 


这 些 界面 元 素 对 应 的 Java 类 都 是 自动 生成 的 ， 而 从 催 辑 角度 来 说 ， 所 有 的 界面 元 素 都 
是 以 接口 的 方式 被 定义 。 其 中 ， 所 有 的 独立 元 素 都 是 从 “IWDUIElement” 和 “1WDViewEle- 
ment” 两 个 抽象 基础 类 继承 而 来 ， 而 复合 元 素 则 是 从 “IWDViewElement” 抽 象 类 继承 而 来 。 
所 有 这 些 元 素 都 有 以 下 的 一 些 通用 属性 。 

1) 标识 (id): 用 来 描述 视图 元 素 的 唯一 标识 。 

2) 是 否 可 用 (enabled) : 是 否 运行 通过 用 户 交 互 触 发 元 素 对 应 的 事件 。 

3) 提示 信息 (tooltip): 当 用 户 鼠 标 悬 停 在 元 素 上 时 ， 弹 出 气泡 文本 用 于 显示 简要 的 说 
明 信 息 。 

4) 是 否 可 见 (visible); 用 于 标识 视图 元 素 是 否 显示 在 页 面 中 。 它 共有 以 下 5 个 选项 。 

e always: 始终 可 见 ， 而 且 用 户 在 进行 客户 端 页 面 个 性 化 配置 时 也 无 法 隐藏 。 

e blank: 空白 ， 不 显示 元 素 ， 但 占用 对 应 空间 。 

® none: 不 可 见 ， 且 不 占用 空间 。 

e notYet: 默认 是 不 可 见 状 态 ， 但 用 户 在 进行 客户 端 页 面 个 性 化 配置 时 可 以 显示 。 

e visible, 默认 可 见 的 状态 

5) 布局 参数 (LayoutData) : 根据 元 素 所 在 容器 的 布局 ， 会 有 特定 的 布局 参数 进行 配置 。 

需要 注意 的 是 ， 部 分 属性 在 选中 后 右 侧 会 出 现 一 个 “Bind” 按 钮 ， 表示 该 属性 允许 与 
上 下 文中 的 特性 进行 绑 定 ， 从 而 更 灵活 地 控制 页 面 元 素 的 显示 和 使 用 。 还 有 部 分 属性 在 空 值 
时 ， 会 有 黄色 叹 号 的 图 标 出 现 作为 提醒 ， 这 表示 该 属性 不 能 为 空 ， 否 则 程序 无 法 运行 。 


4.1.3 元素 的 布局 


在 Web Dynpro 中 ， 布 局 定义 了 对 应 容器 中 所 有 UI 元 素 的 排列 和 位 置 ， 仅 有 容器 类 型 的 
元 素 可 以 找到 对 应 属性 修改 布局 〈 如 透明 容器 、 组 、 托 盘 等 ) 。 如 果 需 要 修改 整个 页 面 的 布 
局 ， 则 可 以 通过 修改 “RootUIElement” 根 结 点 的 布局 属性 来 实现 ， 而 对 于 各 个 子 对 象 的 布 
局 设 定 ， 则 可 通过 子 对 象 的 布局 参数 进行 调整 。 

假设 添加 了 一 个 托盘 元 素 ， 需 要 注意 的 是 ， 它 所 指定 的 “Layout” 布 局 是 针对 它 的 子 对 
象 所 设 定 的 布局 ， 而 左 侧 依然 可 以 看 到 的 “LayoutData” 布局 参数 则 是 将 托盘 作为 一 个 子 对 
象 时 需要 设 定 的 属性 ， 针 对 的 是 它 的 父 对 象 ， 如 图 4-5 所 示 。 这 两 块 属 性 的 配置 千 万 不 能 
混淆 。 

在 Web Dynpro 中 默认 可 用 的 布局 有 
5 种 。 Layout 

1) ColumnLayout ( 列 布局 ) : SDAA aE ae 
中 子 对 象 的 横向 布局 ， 默 认为 3 列 ， 也 可 以 
理解 为 一 个 沙盘 上 默认 划 了 3 道 竖 线 ， 随 后 图 4-5 元 素 的 属性 标签 


H 


Property Value 


4 Properties [Tray] 


id Tray 


layout FlowLayout 


accessibilityDescription 
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去 摆 放 它 的 子 对 象 。 

2) FlowLayout ( 流 布局 ) : 以 一 个 队列 的 方式 去 排列 容 需 中 的 子 对 象 ， 按 从 左 到 右 、 从 
上 到 下 的 顺序 依次 排列 ， 开 发 人 员 可 以 自 定义 换行 的 位 置 ， 默 认 根 据 UI 元 素 的 宽度 以 及 浏 
览 絮 窗口 的 宽度 来 决定 是 否 换行 。 

3) GridLayout (网 格 布局 ) : 所 有 子 对 象 分 布 在 一 个 二 维 的 网 格 之 中 ， 网 格 的 行 数 和 列 
数 都 可 以 自由 配置 。 

4) MatrixLayout (矩阵 布局 ) : 所 有 子 对 象 分 布 在 类 似 于 表格 的 布局 中 ， 与 网 格 布局 较 
为 相似 。 它 不 能 像 网 格 布局 一 样 自 由 配置 行 数 和 列 数 ， 只 能 通过 将 对 应 的 元 素 设 置 为 
“MatrixHeadData” 来 进行 换行 。 和 矩阵 布局 的 优势 在 于 ， 开 发 人 员 可 以 用 它 的 单元 类 方便 地 
创建 出 一 致 布局 的 结构 。 

5) RowLayout ( 行 布局 ) : 强调 容器 中 子 对 象 的 纵向 布局 ， 它 其 实 与 矩阵 布局 类 似 ， 但 
它 是 将 所 有 子 对 象 顺 序 地 放 入 一 列 中 。 


4.1.4 元 素 设计 规则 


为 了 能 在 Web Dynpro 中 更 好 地 进行 界面 设计 和 展现 ， 介 绍 一 些 简单 的 设计 规则 : 

o 不 要 错 用 Web Dynpro 中 的 UI 元素 ， 尽 可 能 了 解 不 同 元 素 的 作用 。 

o 尽量 避免 使 用 固定 的 宽度 和 高 度 ， 同 时 要 考虑 应 用 程序 在 不 同 客户 端的 计算 机 中 可 能 
会 使 用 不 同 的 浏览 吉 或 不 同 的 分 辩 率 的 情况 ， 需 要 根据 实际 情况 进行 具体 调整 。 

© 在 使 用 透明 容器 进行 多 元 素 藤 套 时 ， 需 要 考虑 不 同 容器 的 不 同 布局 ， 尽 可 能 避免 不 必 


RENTRE, 
。 不 要 在 仍 入 容器 中 使 用 滚动 容器 ， 因 为 在 出 现 多 重 的 滚动 页 面 时 ， 用 户 经 常会 无 法 正 
确 移 动 对 应 的 视图 。 


e 在 Web Dynpro 代码 编写 时 ， 对 于 视图 初始 化 的 代码 ， 建 议 放 在 “wdDolInit” 方 法 中 而 
不 是 “wdDoModifyView” 中 ， 这 是 为 了 避免 视图 修改 时 重复 调用 初始 化 代码 ， 降 低 处 
理 效率 。 


4.2 简单 元 素 


4.2.1 按钮 


按钮 是 最 常用 的 元 素 之 一 ， 大 部 分 用 户 事件 都 是 通过 单 击 按钮 进行 触发 和 响应 的 。 

按钮 包含 以 下 属性 。 

© activateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 

种 类 型 。 

e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

© Design; 控制 按钮 的 显示 风格 ,默认 有 标准 显示 、 增 强 显示 、 下 一 步 和 上 一 步 4 种 类 

型 ， 其 中 增强 类 型 即 为 文本 加 粗 显示 ， 见 表 4-1。 

e enabled; 控制 元 素 是 否 可 用 。 

e hotkey: 设置 指定 键盘 组 合作 为 快捷 键 使 用 ,必须 从 下 拉 菜 单 选择 不 可 自 定义 设置 。 
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表 4-1 按钮 的 4 种 类 型 


类 型 图 g 明 

标准 显示 显示 标准 按钮 的 样式 

增强 显示 以 高 亮 方式 显示 按钮 的 样式 

下 一 步 按钮 右 侧 增加 了 一 个 向 右 的 箭头 ， 一 般 用 于 表示 下 一 步 
上 一 步 按钮 左 侧 增加 了 一 个 向 左 的 箭头 ， 一 般 用 于 表示 上 一 步 


© imageFirst: 控制 显示 的 链接 图 标 是 否 位 于 文本 前 面 ， 布 尔 型 属性 。 


e imageSource: 控制 按钮 图 标的 图 片 源 ， 可 以 选择 sap 标准 图 标 或 自 定 义 图 片 。 


e text: 控制 按钮 的 显示 文本 。 
e textDirection: 控制 链接 文本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 往 右 
和 从 右 往 左 。 


è tooltip: 控制 提示 消息 的 显示 文本 〈 对 应 老 版 本 中 的 “imageAlt” 属 性 ) 。 


e visible; 控制 元 素 是 否 可 见 。 


开发 实例 : 
1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “Out- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插 入 子 对 象 ， 选 择 按 钮 类 型 ,输入 ID 名 
称 ， 单 击 “OK” 按 钮 ， 如 图 4-6 所 示 。 


width: 控制 元 素 的 显示 宽度 。 
© onAction 事件 : 用 于 绑 定 按钮 单 击 后 的 响应 动作 。 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category 


Library 


UI Element 


[All] 

Action 
Complex 
Graphic 
Integration 
Layout 
Menu 
Selection 
Text 


Toolbar 


[all] 

Active Components 
Adobe 

Analytics 

Business Graphics 
Business Intelligence 
Calendar 

Mobile Add-Ons 
Office Integration 
Pattern Development 
Realtime Messaging 
Standard 


E ] Accordion 

lki AnalyticsChart 

E ApplicationContainer 
[mM BarCodeReader 

i BlApplicationFrame 


“32 BreadCrumb 


i BusinessGraphics 


| = Button 


E ButtonChoice 
ButtonRow 

E CalendarDayView 
E CalendarMonthView 
国 CalendarPaginator 
E] CalendarWeekView 
图 CalendarVearView 


2) 修改 按钮 属性 中 的 
3) 修改 按钮 属性 中 的 “imageSource” 图 源 ， 选 择 一 个 SAP 标准 图 标 “s_b_okay. gif” , 
如 图 4-8 所 示 。 


4-6 ”选择 元 素 类 型 


“text” XE, WH “E”, 


如 图 4-7 所 示 。 
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= = [mageso ET | 
图 4-7 修改 文本 属性 图 4-8 修改 图 源 属性 


eal 


4) 切换 到 视图 的 上 下 文中 ， 创 建 一 个 结 点 。 由 于 仅 用 于 特性 管理 ， 而 不 是 作为 表格 行 
项 目 ， 因 此 结 点 的 集合 属性 设置 为 “1…1”， 如 图 4-9 所 示 。 


Ci & F © | Property Value 
© Context 4 Documentation 
口 ViewControl Quick info 
Technical Documentation 
4 Misc 


| Collection Cardinality Ld 
Initialize Lead Selection true 


图 4-9 设置 结 点 属性 


5) 创建 类 型 为 “Visibility” 的 特性 “Bt_Visi”。 选 择 创建 一 个 特性 ， 输 入 特性 名 称 ， 
单 击 “Browse” 按 钮 进行 特性 类 型 的 选择 ， 如 图 4-10 所 示 。 


Create a context attribute =] 


: A . B 
Specify whether you want to create the element manually or with context mapping, 9 
model binding or structure binding 


Create With 
© Mapping 
Model Binding 
Structure Binding 
| © Manually 
Name: Bt_Visi 


Type: (sing) aaa) 


F] Calculated 


图 4-10 创建 特性 


6) 在 弹出 对 话 框 中 定位 到 “com. sap. ide. webdynpro. uielementdefinitions” 包 ， 展 开 并 找 
到 可 见 的 类 型 对 象 “Visibility”， 选 中 并 单 击 “OK” 按钮 ， 如 图 4-11 所 示 。 


@ Simple Type 
© Core Data Type 
© Java Native Type 


4 G Local Dictionary 

> 出 com.sap.dictionary.predefined.currency 

> 8 com.sap.dictionary.predefined.objecttypes 

> |H com.sap.ide.webdynpro.uielementdefinitions | 


图 4-11 选择 复杂 类 型 


7) 完成 类 型 选择 ， 确 认 信息 无 误 后 ， 单 击 “Finisn” 按 钮 ， 如 图 4-12 所 示 。 


图 Manually 


Name: Bt_Visi 


Type: |com.sap.ide.webdynpro.uielementdefinitions. Visibility z Browse... 


网 4-12 完成 类 型 选择 后 效果 
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8) 新 增 “boolean” 的 特性 “Bt_Ena”， 如 图 4-13 所 示 。 


- > . B 
Specify whether you want to create the element manually or with context mapping, 9 
model binding or structure binding 


Create With 
© Mapping 
© Model Binding 


© Structure Binding 
© Manually 


Name: Bt_Ena 


Type: | boolean 
F] Calculated 


Z| 4-13 新 建 特性 


9) 完成 特性 创建 后 ， 保 存 所 有 修改 ， 如 图 4-14 所 示 。 
10) 单 击 选中 按钮 元 素 ， 将 创建 的 特性 与 按钮 属性 进行 绑 定 ， 选 中 对 应 属性 ， 单 击 右 
侧 的 “Bind” 按 钮 进行 特性 绑 定 ， 如 图 4-15 所 示 。 


4 © Context 
4 Q ViewControl 
| enabled 一 一 > (Bind) 
日 BtVisi visible [sible Bind 
图 4-14 创建 完毕 后 的 效果 Z 4-15 ”属性 修改 


11) 至 此 ， 完 成 了 按钮 一 般 属性 的 配置 工作 ， 如 图 4-16 所 示 。 
12) 单 击 左 侧 的 “Events” 事 件 标签 ， 进 行 按钮 动作 定义 。 单 击 右 侧 的 “Create” 按 
钮 ， 如 图 4-17 所 示 。 


enabled 目 ViewControl.Bt Ena 
explanation 


General 


hotkey none* 
imageFirst true 


imageSource ~sapicons/s_b_okay.gif 
text 提交 

textDirection inherit* 

tooltip a 

visible B ViewControl.Bt_Vis 
width 


Property 


Events 


| onAction ~ [Go |(Create) 


my 


Z| 4-16 配置 后 的 效果 图 4-17 创建 事件 对 应 动作 


I 


13) 在 弹出 的 对 话 框 中 输入 动作 名 称 ， 单 击 “Finish” 按 钮 ， 如 图 4-18 所 示 。 
14) 保存 所 做 修改 后 ， 双 击 “Submit” 方 法 或 切换 到 Java 编辑 器 ， 实 现 事 件 处 理 髓 。 
添加 代码 ， 如 图 4-19 所 示 。 


wdComponentAPI. getMessageManager( ). reportSuccess( " Submit" ) ; 
15) 创建 组 件 的 应 用 程序 后 ,保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 
测试 。 此 时 按钮 为 灰色 ， 如 图 4-20 所 示 无 法 使 用 。 这 是 因为 我 们 将 是 否 可 用 的 属性 与 视图 
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Name Submit 


Text 


Icon Browse... 


Validation 区 
Event Handler 
@ Use Default 


onActionSubmit 


© Use Existing 


J| Adapt parameters to fit event handler parameters 


Fire Plug |<None> -| | News| 


器 


4-18 输入 动作 名 称 


/** 


* Declared validating event handler. 
* 


* 
*/ 
//@@end 


@param wdEvent generic event object provided by framework 


{ 


public void onActionSubmit (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 


//@@begin onActionSubmit (ServerEvent) 一 一 
wdComponentAPI .getMessageManager () - reportSuccess ("Submitf") 六 
//@@end 
Lt 
图 4-19 添加 代码 


上 下 文 进行 了 绑 定 ， 但 未 对 上 下 文 进行 赋值 ， 黑 认为 空 值 ， 即 对 应 
“false” 的 显示 效果 。 


7 也 


16) 进入 到 视图 的 “wdDomit” 初 始 化 方法 中 ， 初 始 化 时 赋值 该 ”图 4-20 运行 效 


变量 为 “true”， 如 图 4-21 所 示 。 


//@@begin javadoc:wdDoInit () 

/** Hook method called to initialize controller. */ 

//@@end 

public void wdDoInit () Pg 

{ we 

//@@begin wdDoInit () 在 一 
wdContext .nodeViewControl|()|. currentViewControlElement () .setBt_Ena (true) ; 
//@@end 
} 
图 4-21 添加 代码 
17) 重新 部 署 运行 后 , “提交 ”按钮 可 用 ， 单 击 该 按钮 即 可 看 到 = 
对 应 的 提示 消息 ， 如 图 4-22 所 示 。 
=] 4, S y 元 人 六 人 FAL 
18) 对 应 另 一 个 是 否 可 见 的 上 下 文 ， 也 可 以 同样 在 初始 化 方法 ”图 4-22 运行 效果 
中 进行 赋值 ， 如 图 4-23 所 示 。 
//@@begin javadoc:wdDoInit () 
/** Hook method called to initialize controller. */ 
//@@end 
public void wdDoInit () 
{ f 
//@@begin wdDoInit () f 
wdContext .nodeViewControl () .currentViewControlElement () .setBt_Ena (true) ; y 
wdContext .nodeViewControl () .currentViewControlElement () .setBt_Visi(WDVisibility. NONE) ; 
//@@end 

} 


BS 


4-23 ”添加 代码 


156 


编译 运行 后 ， 提 交 按 钮 即 不 再 显示 ， 读 者 也 可 以 根据 通用 属性 中 的 介绍 ， 进 行 其 他 的 可 
视 属 性 配置 ， 并 验证 实际 页 面 中 的 显示 效果 。 


4.2.2 文本 框 


文本 框 包含 以 下 属性 。 
e activateAccessKey: 设置 是 否 允 许 使 用 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事 
件 ) O 


e alignment: 控制 文本 框 中 文本 显示 的 位 置 ， 如 靠 左 、 靠 右 或 居中 等 。 

e autoTab; 控制 用 户 是 否 可 以 通过 “Tab” 键 进行 快速 跳 转 ， 布 尔 型 属性 。 

è contextMenuBehaviour; 设置 上 下 文 菜 单行 为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 

e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

e defaultDateRefld: 设置 默认 的 引用 日 期 标识 。 

e displayAsText: 控制 是 否 以 文本 形式 显示 ， 如 设置 为 “true”， 则 在 视图 中 的 显示 效果 

与 “TextView” 一样 。 

enabled; 控制 元 素 是 否 可 用 。 

imeMode: 控制 是 否 允 许 本 地 计算 机 中 的 输入 法 进行 文本 输入 。 

inputPromt: 控制 焦点 在 文本 框 中 时 的 默认 输入 提示 。 

length: 控制 文本 框 的 显示 长 度 。 

onEnterBehavior: 控制 在 文本 框 中 回 车 时 的 响应 事件 。 

passwordField: 控制 是 否 以 密码 方式 显示 输入 值 ， 即 当 属性 值 为 tue 时 ， 输 入 框 将 显 

示 “* * *” 作 为 密码 输入 。 

readOnly: 控制 文本 框 是 否 只 读 。 

state :控制 元 素 的 显示 状态 ,默认 有 “normal” 和 “required” 两 种 状态 。 在 选择 

“required” 后 ,元素 会 出 现 一 个 红色 星 号 进行 提醒 ,， 但 逻辑 控制 仍 需 要 编写 相关 

代码 。 

suggestedValue: 控制 是 否 有 推荐 值 。 

textDirection : 控制 链接 文本 的 排列 顺序 ， 默认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 往 右 

和 从 右 往 左 。 

tooltip: 控制 提示 消息 的 显示 文本 。 

value; 文本 框 中 输入 值 所 对 应 的 上 下 文 特 性 ， 文 本 框 的 关键 属性 。 另 外 ， 文 本 框 元 素 

的 显示 方式 与 绑 定 变量 类 型 有 直接 关系 ， 当 变量 类 型 为 日 期 类 型 时 ， 文 本 框 元 素 会 自 

动 显 示 日 期 搜索 帮助 。 同 样 当 类 型 为 数字 或 整 型 时 ， 界 面 元 素 会 提供 数字 型 搜索 并 有 

类 型 合法 性 校 验 。 

e visible; 控制 元 素 是 否 可 见 。 

e width, 控制 元 素 的 显示 宽度 。 

e onChange 事件 ， 当 文本 框 的 值 发 生 改 变 并 且 失 去 鼠标 焦点 或 按 (Enter) RMR, 

© onEnter 事件 : HF (Enter〉 键 时 触发 (如 果 文 本 框 属性 是 “SuggestValues” 并 且 
“onEnterBehavior” 设置 为 “no” 上 时， 则 不 会 触发 该 动作 ) 。 

ìt: 4A “onChange” 事件 时 ,“onEnter” 事件 不 会 被 触发 ， 即 不 论 是 文本 框 的 值 发 
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生 改 变 、 输 入 框 失 去 鼠标 焦点 ， 还 是 按 〈Enter〉 键 ， 都 会 优先 触发 “onChange” 事件 ， 而 


ual 


Bkat “onEnter” 


开发 实例 : 


< 


mike 


1) 打开 任意 一 个 视图 ， 添 加 一 个 文本 框 。 右 击 “Outline” 中 的 “RootElement” 根 结 点 ， 
选择 插入 子 对 象 ， 选 择 “InputField”, 输入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-24 所 示 。 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Library 


UI Element 


[ally 

Action 
Complex 
Graphic 
Integration 
Layout 
Menu 
Selection 
Text 
Toolbar 


[All] 

Active Components 
Adobe 

Analytics 

Business Graphics 
Business Intelligence 
Calendar 

Mobile Add-Ons 
Office Integration 
Pattern Development 
Realtime Messaging 
Standard 


— HorizontalGutter 
o IFrame 

EB Image 

Reb InputField 

GE InputTokenizer 


= ` 
-3| InteractiveForm 


InvisibleElement 
=} ItemListBox 
Label 

| Legend 

“tH LinkChoice 

== LinkToAction 
“3 LinkToURL 

“o MeltingGroup 
=} MenuBar 


=.. A 


ERE 


2) 再 添加 一 个 标签 ， 右 击 “Outline” 中 的 “RootElement” 根 结 点 ， 


PS 


4-24 ”选择 元 素 类 型 


EFE “Label”, 输入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-25 所 示 。 


选择 插入 子 对 象 ， 
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图 4-25 选择 元 素 类 型 


UI Elem 
|| 
Create a new UI element 
Select the UI element you want to create. You can also enter an ID for it 
Library UI Element 
[All] [All] “| Image a 
Action Active Components ee InputField 
Complex Adobe {ie InputTokenizer 
A Graphic Analytics E] InteractiveForm 
Integration Business Graphics 国 InvisibleElement 
Layout Business Intelligence Ef ItemListBox 
Menu Calendar T Label 
I| | Selection Mobile Add-Ons 到 Legend z 
Text Office Integration “tl LinkChoice 
Toolbar Pattern Development == LinkToAction 
Realtime Messaging “G LinkTOURL 
Standard "o MeltingGroup 
SR MenuBar 
Ei MessageArea 
E? MessageBasedTrigger a 
PR 
eid Label | 


3) 打开 标签 的 属性 ， 在 “labelFor” 属 性 中 选择 之 前 创建 的 “Id_Input” 的 文本 框 的 
ID, “text” 属性 输入 “Id”， 如 图 4-26 所 示 。 

4) 完成 标签 的 修改 后 ， 接 着 打开 文本 框 的 属性 ， 在 “state” 状 态 属性 中 选择 
“requied” 表示 文本 框 必 填 ， 如 图 4-27 所 示 。 


T Label 
General | Property | Value 
4 Properties [Label] 
La Data 
yout id Id_Label 
contextMenuBehaviour inherit* 
Me Ta InputField 
design standard* z 
designBar standard* General onEnterBehavior default* 
enabled true passwor dField false 
lata 
labelFor Id_Input layoutData readOnly false 
| text Id Events | state 
二 Fe VE A =y 
图 4-26 修改 标签 属性 图 4-27 修改 输入 框 属性 


5) 完成 修改 后 ,保存 所 有 修改 ， 在 视图 中 会 看 到 文本 框 前 多 了 一 个 红色 星 号 ， 提 示 用 户 
必 填 ， 但 元 素 中 属性 修改 只 是 页 面 上 提示 ， 人 逻辑 判断 还 需要 额外 编写 代码 实现 ， 如 图 4-28 
所 示 。 

6) 在 “inputPromt” 属 性 输入 “Enter Id”, 保存 修 改 后 ， 页 面 效 果 如 图 4-29 所 示 。 

7) 如 果 这 时 保存 并 编译 、 运 行程 序 ， 会 提示 文本 框 的 值 未 绑 定 上 下 文 ， 这 是 由 于 文本 
框 对 于 用 户 的 输入 必须 有 对 应 的 上 下 文 进行 保存 。 切 换 到 视图 的 上 下 文中 ,创建 一 个 名 称 为 
“Td”、 类 型 为 “String” 的 特性 ， 如 图 4-30 所 示 。 


4 © Context 
ld: * id: * | Enter Id Eg 


图 4-28 预览 效果 图 4-29 ”运行 效果 图 4-30 创建 特性 后 的 效果 


8) 将 文本 框 的 属性 中 的 “value” 与 上 下 文 进 行 绑 定 ， 如 图 4-31 所 示 。 
9) 保存 所 有 修改 后 ， 编 译 、 部 署 并 运行 视图 对 应 的 程序 ， 运 行 效果 如 图 4-32 所 示 。 


fe InputField 


z 


onEnterBehavior default* 


General 
passwordField false 


readOnly false 
state required 


suggestValues false 


textDirection inherit* 
tooltip a 
value 日 Id 


visible visible* 


图 4-31 修改 属性 后 的 效果 图 4-32 ”运行 效果 


10) 下 面 继续 测试 文本 框 的 其 他 属性 以 及 实现 后 的 实际 效果 。 首 先 ， 在 文本 框 后 添加 
一 个 按钮 ， 用 于 后 面 的 测试 。 在 “text” 文 本 框 中 输入 “打印 ”， 图 标 选 择 “SAP Icon” PR 
准 图 标 中 的 “s_b_prnt. gif”， 如 图 4-33 所 示 。 

11) 随后 添加 一 个 方法 ， 在 代码 中 添加 打印 逻辑 ， 用 于 打印 文本 框 内 的 文本 ， 如 图 4-34 
所 示 。 


wdComponentAPI. getMessageManager( ). reportSuccess( wdContext currentContextElement( ). getld( ) ) ; 


159 


= Button 
General enabled true 
z = =| explanatio 
LayoutData _ P n 
一 | hotkey none* 
Evens imageFirst true 
| imageSource ~sapicons/s_b_prnt.gif 
text 打印 


图 4-33 ”修改 属性 


12) 将 文本 框 的 “passwordField” 属 性 设置 为 “rue”， 编 译 运 行 后 的 效果 如 网 4-35 
所 示 。 
13) 单 击 “ 打 印 ” 按 钮 后 ,下方 消息 区 域 会 提示 输入 内 容 ， 如 图 4-36 所 示 。 


1: * [@d Bian] | | [eee Errrrrr fan] E password 


Al 4-34 预览 效果 图 4-35 运行 图 4-36 单 击 打 印 按 钮 效果 


14) 将 文本 框 的 “readOnly” 只 读 属 性 设置 为 “true”， 如 图 4-37 所 示 。 
15) 在 文本 框 的 事件 属性 中 ,创建 “onChange” 和 “onEnter” 事 件 ， 如 图 4-38 所 示 。 


4 Events 
onChange ChangeValue 
id | La aren onEnter Confirm 
图 4-37 ”运行 效果 图 4-38 创建 事件 


“onChange” 事 件 参考 代码 如 下 : 


//@ @ begin onActionChangeValue( ServerEvent ) 


wdComponentAPI. getMessageManager( ). reportSuccess(" OnChange" + wdContext currentContext-El- 
ement( ). getId( ) ) ; 
//@ @ end 


“onEnter” 事件 参考 代码 如 下 : 


//@ @ begin onActionConfirm (ServerEvent) 

wdComponentAPI. getMessageManager( ). reportSuccess ( " OnEnter" + wdContext. currentContext- 
Element( ). getId( ) ) ; 

//@ @ end 


16) 保存 所 有 修改 ， 并 重新 编译 ， 运 行 即 可 进行 测试 ， 运 行 效 果 如 图 4-39 所 示 。 
17) 经 测试 可 以 发 现 , 不 论 是 输入 任意 文本 按 (Enter〉 键 ,还 是 输入 文本 后 单 击 页 面 
其 他 位 置 ， 触 发 的 都 是 “onChange” 对 应 的 事件 ， 如 图 4-40 所 示 。 


id: * [12345 打印 OnChange:12345 
图 4-39 运行 效果 图 4-40 触发 事件 效果 


18) 回 到 视图 的 属性 ， 将 文本 框 事件 中 的 “onChange” 动 作 清空 ， 仅 保留 回 车 事件 ， 
如 图 4-41 所 示 。 
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4 Events 
onChange 


onEnter Confirm 


图 4-41 ”修改 事件 属性 


19) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ,输入 值 并 按 《Enter〉 键 即 可 触发 对 应 的 
回 车 响应 事件 ， 如 图 4-42 所 示 。 

注 ; 在 项 目 实施 过 程 中 ， 一 般 回 车 事件 使 用 的 更 多 ， 如 报表 查询 时 用 户 经 常 提 出 输入 有 
效 值 后 回 车 即 能 看 到 结果 ， 这 时 候 开 发 人 员 就 需要 创建 回 车 事件 并 且 绑 定 与 单 击 “ 查 询 ” 
按钮 相同 的 动作 进行 响应 。 

20) 在 Web Dynpro 中 ， 文 本 框 也 会 随 着 所 绑 定 的 上 下 文 类 型 进行 一 些 特别 的 显示 。 例 
如 ， 将 上 下 文 “Id” 的 类 型 从 “String” 字 符 串 改 为 “date” 日 期 ， 随 后 保存 所 有 修改 ， 并 
重新 编 、 译 运行 ， 如 图 4-43 所 示 。 

21) 文本 框 的 右 侧 多 了 一 个 日 历 的 小 图 标 ， 单 击 即 可 弹出 对 应 的 日 历 控 件 进行 日 期 选 
择 ， 如 图 4-44 所 示 。 


ld: * | Enter Id Hl 是 ;打印 


图 4-42 运行 效果 1 图 4-43 ”运行 效果 2 图 4-44 日 历 控件 效果 


4.2.3 关键 字 下 拉 列 表 


一 个 关键 字 下 拉 列 表 给 用 户 提 供 了 一 个 下 拉 清 单 ， 而 且 用 户 仅 能 选择 最 多 一 个 条 目 。 这 
个 元 素 其 实 是 由 一 个 文本 域 、 一 个 按钮 和 一 个 选择 列表 组 成 的 ， 单 击 下 拉 按 钮 可 以 看 到 清单 
中 所 有 可 选 的 条 目 ， 而 选中 的 条 目 将 会 在 文本 域 中 进行 显示 。 
关键 字 下 拉 列 表 一 直 是 较 和 常见 的 页 面 元 素 ， 它 的 可 选 范围 可 以 通过 字段 所 对 应 的 类 型 来 
个 性 化 。 当 下 拉 列 表 框 的 条 目 达到 一 定数 量 时 ， 下 拉 列 表 元 素 会 自动 转换 为 弹出 式 的 输入 帮 
助 对 话 框 。 
下 拉 列 表 包 含 以 下 属性 。 
e activateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 
© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 
e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 
e displayAsText: 控制 是 否 以 文本 形式 显示 ， 如 设置 为 “true”， 则 在 视图 中 的 显示 效果 
与 “TextView” 一 样 。 
è enabled; 控制 元 素 是 否 可 用 。 
e labelFor: 用 于 设置 元 素 对 应 的 显示 标签 。 
è readOnly: 控制 元 素 是 否 只 读 。 
e selectedKey: 绑 定 控件 操作 的 上 下 文 特 性 。“selectedKey” 为 值 选择 后 赋值 变量 。 对 于 
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静态 下 拉 框 来 讲 ， 下 拉 框 的 选择 范围 可 以 通过 在 数据 字典 中 建立 简单 类 型 进行 指定 ， 
此 时 上 下 文 特性 的 类 型 需要 选择 该 简单 类 型 。 
state: 控制 元 素 的 显示 状态 ， 默认 有 “normal” 和 “required” 两 种 状态 。 在 选择 
“required” 后 ， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ， 但 逻辑 控制 仍 需 要 编写 相关 
代码 。 
© suggestedValue: 控制 是 否 有 推荐 值 。 
© textDirection: 控制 下 拉 列 表 显 示 文 本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 
从 左 往 右 和 从 右 往 左 。 
tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

e width, 控制 元 素 的 显示 宽度 。 

e onSelect 事件 : 当 用 户 选择 某 一 确定 值 时 ， 会 触发 该 事件 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “Out- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 关键 字 下 拉 列 表 类 型 ， 
输入 ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-45 所 示 。 


四 New UI Elem 


Create a new UI element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] [All] (E DropDownByKey 
Action Active Components iS. DropTarget 
Complex Adobe E} Explanation 
Graphic Analytics E5 FileDownload 
Integration Business Graphics Ñ$ FileDropTarget 


Layout Business Intelligence [2 FileUpload 

Menu Calendar E FormattedTextEdit 

Selection Mobile Add-Ons [E] FormattedTextView 

Text Office Integration Fn) FunctionKey 

Toolbar Pattern Development Gantt 

Realtime Messaging &GeoMap 

Standard E7] Group 

É HierarchicalCalendarMonthView 
@ HorizontalContextualPanel 


— HorizontalGutter 


= 


ID DropDownByKey 


图 4-45 ”选择 元 素 类 型 


2) 切换 到 视图 的 上 下 文 页 签 中 ， 创 建 类 型 为 “string” 的 特性 “dept”， 如 图 4-46 
所 示 。 

3) 选中 关键 字 下 拉 列 表 , 将 “selectedKey” 所 选 关 键 字 属性 绑 定 为 上 下 文中 的 
“dept”, Wil 4-47 所 示 。 


4 © Context 
[日 dept) 
图 4-46 创建 特性 图 4-47 属性 修改 
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4) 添加 一 个 “Label” 标 签 ， 将 属性 中 的 “text” 修 改 为 “部 门 ”。 保 存 所 有 修改 ， 并 
编译 、 运 行 ， 运 行 效果 如 图 4-48 所 示 。 

5) 由 于 当前 绑 定 的 上 下 文 是 一 个 字符 串 类 型 ， 因 此 并 不 能 实现 多 个 条 目的 效果 。 下 面 
创建 一 个 简单 类 型 进行 条 目 填充 。 在 工程 目录 中 (窗口 的 下 方 ) 找到 “Ditionaries” 一 
“Local Dictionary” — “Data Types”, Hii “Simple Types”， 选 择 “Create Simple Type”， 如 
图 4-49 所 示 。 


4 @ Dictionaries 
4 G Local Dictionary 
4 Data Types 


|G Simple Types | 
图 4-48 ”运行 效果 图 4-49 创建 简单 类 型 


6) 根据 需求 输入 简单 类 型 的 名 称 和 包 名 ， 其 中 简单 类 型 的 包 名 也 可 直接 选择 现 有 的 
包 ， 单 击 “Finish” 按 钮 ， 如 图 4-50 所 示 。 


Simple Type Name: Dept 


Simple Type Package: com.sap.demo.mydynp04.wd.ddic Browse... 


FA 4-50 输入 简单 类 型 信息 


7) 创建 完成 后 ， 即 可 对 创建 的 简单 类 型 进行 详细 的 配置 。 上 方 是 一 般 信 息 定义 ， 主 要 
关注 类 型 的 定义 ; 下 方 是 对 于 长 度 稼 量 的 定义 ; 最 下 方 还 有 其 他 3 个 页 签 ， 其 中 “Enumera- 
tion” 是 定义 集合 中 的 所 有 条 上 日， 如 图 4-51 所 示 。 


Simple Type Definition 
~ General Information 
Define general properties of the simple type 


Name: dept 


Package: com.sap.demo.mydynp04.wd.ddic 


Dictionary: Local Dictionary 


Base Type: 


Built-In Type: |istri 


Description: 


~ Length Constraints 


Define constraints on string length or on digits 


Maximum Length: | 


Minimum Length: [ 


Fixed Length: 


Teall mtu 


Definition | Enumeration Representation | Database 


图 4-51 简单 类 型 的 定义 页 面 


8) 切换 到 “Enumeration” 页 签 ， 单 击 “New” 按 钮 ， 定 义 值 范围 ， 如 图 4-52 所 示 。 
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Enumeration Value: 01 
Enumeration Text: ” 人事 部 
图 4-52 ”输入 信息 


9) 依次 输入 多 个 部 门 ， 单 击 “ 完 成 ”按钮 并 保存 所 有 修改 ， 如 图 4-53 所 示 。 


Value Description 
01 ABS 
02 网 络 部 
03 采购 部 


4-53 ”完成 后 的 效果 


10) 回 到 视图 的 上 下 文 页 签 中 ， 选 择 “dept” 特 性 ， 并 修改 它 的 类 型 ， 如 图 4-54 所 
示 。 注 意 ， 修 改 类 型 时 如 果 单 击 下 拉 列 表 框 只 能 看 到 一 些 基 本 类 型 ， 需 要 单 击 右 侧 的 “...” 
按钮 。 

11) 在 弹出 的 对 话 框 中 找到 之 前 创建 的 包 以 其 对 应 的 “dept”， 选 中 后 单 击 “OK” 按 
钮 ， 如 图 4-55 所 示 。 


Type Selection 王 
Type Selection 
Select a type 
Property Value ee 
Calculation © Core Data Type 
Calculated false a i 
= © Java Native Type 
Misc r 
Name dept p 
Read-Only false | 4 |@ Dictionaries | 
Semantic ID 4 G Local Dictionary 
Structure Element pi > £8 com.sap.dictionary.predefined.currency 
| Type + [me] [Go p > 出 com.sap.dictionary.predefined.objecttypes 
4 出 com.sap.demo.mydynp04.wd.ddic 
dept 


图 4-54 ”修改 类 型 图 4-55 选择 对 应 类 型 


12) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 就 能 正确 地 使 用 关键 字 下拉 列 表 了 ， 如 
图 4-56 所 示 。 

13) 细心 的 读者 会 发 现 ， 下 拉 列 表 的 宽度 自动 进行 了 调整 ， 它 会 根据 所 绑 定 类 型 中 的 
文本 长 度 自动 进行 调整 ， 如 图 4-57 所 示 。 可 以 通过 修改 下 拉 列 表 的 “width” 属性 来 固定 修 
改元 素 的 宽度 。 通 党 在 页 面 布局 时 并 不 建议 直接 将 元 素 宽度 设置 为 固定 值 ， 设 定 百 分 比 的 形 
式 会 让 页 面 布局 变 得 灵活 。 

14) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 就 能 看 到 下 拉 列 表 最 终 的 运行 效果 ， 如 
图 4-58 所 示 。 


wit: 了 width 100px 


= 


图 4-56 ”运行 效果 图 4-57 “width” 属 性 图 4-58 运行 效果 


15) 由 于 下 拉 列 表 中 的 条 目 与 元 素 所 绑 定 的 简单 类 型 中 的 “Enumeration” 对应， 因此 
再 次 修改 “dept”， 添 加 一 行 空 值 ， 如 图 4-59 所 示 。 
164 


Description 


Fl 4-59 修改 值 


16) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 选 择 范 
围 中 多 出 了 空 值 选 择 ， 可 以 通过 空 值 来 重 置 下 拉 输 入 ， 如 
图 4-60 所 示 。 

17) 在 下 拉 列 表 的 默认 事件 中 创建 一 个 动作 ， 如 
4-61 所 示 。 Al4-60 运行 效果 


IR] 


4 Events 
onSelect SelectValue 


图 4-61 创建 对 应 事件 


18) 添加 打印 代码 ， 即 在 选择 条 目 时 将 选中 后 的 上 下 文 的 值 打 印 在 页 面 上 ， 如 图 4-62 
所 示 。 


wdComponentAPI. getMessageManager( ). reportSuccess( wdContext currentContextElement( ). getDept) ; 


public void onActionSelectValue (com. sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 
{ 
//@@begin onActionSelectValue (ServerEvent) 
wdComponentAPI .getMessageManager () . reportSuccess (wdContext.currentContextElement () .getDept Op G 
//@@end 


} 


R| 4-62 ”添加 代码 


19) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 选 择 任意 一 个 条 目 (WME 4-63), HH 
会 打印 出 关键 字 ( 见 图 4-64)， 而 不 是 关键 字 对 应 的 描述 


ai: (ABH v 01 


图 4-63 ”运行 效果 图 4-64 选择 后 的 效果 
4.2.4 复 选 框 
dd 真 与 假 (是 与 否 ) 的 选择 ， 如 果 复 选 框 是 选中 的 状 
态 ， 则 对 应 的 变量 值 是 “t ， 如 果 是 未 选中 状态 ， 则 表示 的 是 “false”。 
复 选 框 包 含 以 下 属 性 。 
e activateAccessKey: 设置 是 否 人 允许 使 用 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 
事件 ) 。 


e checked; 用 于 控制 复 选 框 是 否 选中 ， 必 须 绑 定 上 下 文 特 性 。 
© contextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 
e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 
e enabled; 控制 元 素 是 否 可 用 。 
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e explanation: 设置 元 素 的 解释 文本 ， 设 置 后 元 素 文 本 下 方 会 出 现 一 条 绿色 的 下 画 线 。 
当 鼠 标 悬 停 在 文本 上 时 ， 会 弹出 解释 文本 的 说 明 。 
è readOnly: 控制 元 素 是 否 只 读 。 
estate: 控制 元 素 的 显示 状态 ， 默 认 有 “normal” 和 “required” 两 种 状态 。 在 选择 
“required” 后 ， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ， 但 逻辑 控制 仍 需 要 编写 相关 
代码 。 
e text: 控制 复 选 框 显示 的 描述 文本 内 容 。 
e textDirection: 控制 下 拉 列 表 显 示 文 本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 
从 左 往 右 和 从 右 往 左 。 
e tooltip: 控制 提示 消息 的 显示 文本 。 
e visible: 控制 元 素 是 否 可 见 。 
© onToggle 事件 : 用 户 选择 不 同 复 选 框 时 触发 的 事件 。 
开发 实例 : 
1) 打开 任 一 视图 (如果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “Out- 
line” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 复 选 框 类 型 ,输入 ID 
名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-65 所 示 。 


[TO 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[all] [All] l CalendarMonthView a 
Action Active Components El CalendarPaginator 
Complex Adobe E CalendarWeekView 
Graphic Analytics E CalendarYearView 4 
Integration Business Graphics T Caption 
Layout Business Intelligence | CheckBox | 
Menu Calendar gr: CheckBoxGroup 
Selection Mobile Add-Ons Q ContextualPanel 
Text Office Integration fl DateNavigator 
Toolbar Pattern Development EF DropDownBylndex | 
Realtime Messaging E DropDownByKey | 
Standard iS: DropTarget 
2] Explanation 
E5 FileDownload 
{iS FileDropTarget fy 


| ID CheckBox 


4-65 选择 元 素 类 型 


2) 复 选 框 与 文本 框 一 样 ， 也 有 必须 与 上 下 文 绑 定 的 属性 ， 在 属性 中 可 以 看 到 提醒 绑 定 
的 图 片 ， 如 图 4-66 所 示 。 

3) 创建 一 个 新 的 特性 并 与 复 选 框 绑 定 ， 将 “text” 文 本 修改 为 “按钮 可 用 ”， 如 
图 4-67 所 示 。 

4) 将 同一 个 特性 与 按钮 的 “Enabled” 是 否 可 用 属性 绑 定 ， 如 图 4-68 所 示 。 

5) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 会 发 现 此 时 单 击 复 选 框 并 不 会 改变 按钮 的 
状态 ， 如 图 4-69 所 示 。 
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M CheckBox 


| checked BViewControl.Bt_Ena 
contextMenuBehaviour inherit* 
Ai CheckBox contextMenuld 
enabled true 
General Property Value explanation 
LayoutData 4 Properties [CheckBox] readOnly false 
id CheckBox state normal* 
Events activateAccessKey false text 按钮 可 用 
checked [Bind | textDirection inherit* 
图 4-66 修改 属性 1 图 4-67 修改 属性 2 
= Button 
design standard* 
General | enabled B ViewControl.Bt_Ena 
LayoutData explanation 
Events hotkey none* 
imageFirst true 


图 4-68 修改 属性 3 图 4-69 ”运行 效果 


6) 回 到 复 选 框 的 事件 属性 中 ， 任 意 绑 定 一 个 动作 ， 即 使 实现 代码 为 空 也 没有 关系 (I 
图 4-70) ， 保 存 所 有 修改 ， 并 重新 编译 、 运 行 。 

7) 此 时 单 击 复 选 框 后 ， 按 钮 的 是 否 可 用 属性 也 会 同时 修改 ， 未 选中 的 状态 时 按钮 也 是 
灰色 不 可 用 状态 (JILE 4-71), 


M CheckBox 


property Value 


4 Events 


| onToggle Blank 


图 4-70 创建 事件 图 4-71 ”运行 效果 


在 上 述 测试 结果 后 可 以 发 现 ， 只 有 在 视图 元 素 绑 定 了 特定 的 事件 之 后 ， 才 会 触发 视图 控制 
顺 的 逻辑 ， 同 时 会 去 刷新 上 下 文 特性 的 值 。 相 对 而 言 ， 在 复 选 框 未 绑 定 事件 时 ， 不 管用 户 如 何 
点 击 复 选 框 ， 这 些 操 作 也 仅仅 存在 于 用 户 客户 端的 浏览 器 中 ， 并 未 触发 至 服务 端 进行 响应 。 


4.2.5 单 选 按钮 


单 选 按钮 可 以 看 作 一 个 拥有 两 个 状态 (FXX) 的 按钮 ， 一 般 也 会 使 用 单 选 按钮 组 为 用 
户 提供 选项 。 当 然 ， 如 果 条 目 太 多 ， 还 是 建议 使 用 下 拉 列 表 。 

单 选 按钮 包含 以 下 属性 。 

e activateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

e contextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 

e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

e enabled; 控制 元 素 是 否 可 用 。 

e explanation: 设置 元 素 的 解释 文本 ,设置 后 元 素 文 本 下 方 会 出 现 一 条 绿色 的 下 面 线 。 
当 鼠 标 巧 停 在 文本 上 时 ， 会 弹出 解释 文本 的 说 明 。 

e keyToSelect: 当前 单 选 按钮 对 应 的 键 。 

e readOnly: 控制 元 素 是 否 只 读 。 
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line” 


名 称 


selectedKey: 绑 定 的 上 下 文 结 点 数据 源 。 

state: 控制 元 素 的 显示 状态 ， 默 认 有 “normal” 和 “required” 两 种 状态 。 在 选择 

“required” 后 ， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ,但 逻辑 控制 仍 需 要 编写 相关 

代码 。 

e text: 控制 复 选 框 显示 的 描述 文本 内 容 。 

e textDirection: 控制 下 拉 列 表 显 示 文 本 的 排列 顺序 ， 默认 有 3 个 选项 : 继承 自 父 元 素 、 
从 左 往 右 和 从 右 往 左 。 

e tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

e onSelect 事件 : 在 用 户 选择 时 触发 的 事件 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “ Out- 
元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插 入 子 对 象 ， 选 择 单 选 按 钮 类 型 ,输入 ID 

， 单 击 “OK” 按 钮 ， 如 图 4-72 所 示 。 


New UI Elem 
Create a new UI element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 
fall] [all] |@ RadioButton 
Action Active Components $i: RadioButtonGroupBylndex 
Complex Adobe $? RadioButtonGroupByKey 
Graphic Analytics @) RFAIDReader 
Integration Business Graphics bea RoadMap 
Layout Business Intelligence E RowRepeater 
Menu Calendar C] ScrollContainer 
Selection Mobile Add-Ons E] SectionHeader 
Text Office Integration @ Shuttle 
Toolbar Pattern Development | Splitter 
Realtime Messaging lH Table 
Standard E] TabStrip 
E3] TextEdit 
TextView 
@ TimedTrigger 
P aa = 
|| ID RadioButton 


图 4-72 ”选择 元 素 类 型 


2) 再 添加 一 个 单 选 按钮 和 一 个 标签 ， 如 图 4-73 所 示 。 

3) 编辑 标签 文本 为 “性 别 ”， 编 辑 两 个 单 选 按钮 的 文本 分 别 为 “ 男 ” 和 “ 女 ”， 如 
图 4-74 所 示 。 

4) 进入 视图 的 上 下 文 页 签 中 ， 创 建 一 个 字符 串 类 型 的 上 下 文 “gendor”， 如 图 4-75 


所 示 。 


168 


RootElement 


oS 4 O Context 
® RadioButton - 
® RadioButton1 性 别 : ©F Ox [|B gendor| 
图 4-73 创建 后 的 效果 图 4-74 运行 效果 图 4-75 创建 特性 


5) 将 第 一 个 单 选 按钮 的 “KeyToSelect” 改 为 “1”， 随 后 绑 定 “gendor” 上 下 文 特性 ， 
如 图 4-76 所 示 。 


RadioButton 


6) 将 第 二 个 单 选 按钮 的 “keyToSelect” 改 为 “2”， 随 后 绑 定 “gendor” 上 和 下文 特 性 ， 
如 图 4-77 所 示 。 


keyToSelect i keyToSelect 2 

readOnly false readOnly false 

selectedKey B gendor selectedKey B gendor 
图 4-76 修改 属性 图 4-77 ”修改 属性 


7) 在 单 选 按钮 的 事件 中 创建 “Select” 动 作 ， 同 时 将 另 一 个 单 选 按钮 的 时 间 处 理 也 与 
“Select” 动作 进行 绑 定 ， 如 图 4-78 所 示 。 
8) 在 创建 动作 时 ， 添 加 一 个 字符 串 类 型 的 输入 参数 “key”， 如 图 4-79 所 示 。 


Details Parameters | 
4 Events Name Type 
onSelect Select key string 
图 4-78 创建 事件 图 4-79 ”添加 动作 参数 


9) AÈ “Outline” 清单 中 的 单 选 按 钮 ， 选 择 “Parameter Mapping” 创建 参数 映射 (如 
果 在 创建 动作 时 不 添加 对 应 参数 ， 则 无 法 进行 映射 ) ， 将 单 选 按钮 所 选 的 关键 字 与 创建 的 动 
作 中 的 参数 进行 映射 ， 如 图 4-80 所 示 。 


4 RadioButton Actions 
4 >|— [eq] 
key > key 


nodeElement 


图 4-80 添加 参数 映射 


10) 保存 所 做 修改 ， 切 换 至 Java 编辑 器 ， 在 “Select” 动 作 的 方法 中 添加 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess( key) ; 


11) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 测试 单 击 单 选 按钮 的 效果 ， 如 图 4-81 
所 示 。 
12) 单 击 按钮 后 ， 可 以 看 到 打印 出 的 具体 内 容 ， 如 图 4-82 所 示 。 


国 1 


图 4-81 运行 效果 图 4-82 ”选择 后 的 效果 


4.2.6 工具 栏 


工具 栏 是 一 个 工具 的 集合 ， 或 者 可 以 看 成 一 种 特殊 的 容器 ， 因 此 工具 栏 中 也 可 以 添加 若 
干 子 元 素 用 于 实现 不 同 的 功能 ， 如 按钮 和 下 拉 列 表 等 ， 如 图 4-83 所 示 。 
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工具 栏 包含 了 了 以 下 属性 o UI Element 
e accessibilityDescription; 当 这 个 属性 激活 时 ， 描 述 的 文本 就 M CalandarPaginator 


"= ToolBarButton 


会 显示 在 提示 消 息 中 5 E ToolBarButtonChoice 

. i E N R ape iF ToolBarDropDownByIndex 
contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “ 继 |) exp tocitardropdownByKey 
承 ” “ 人 允许 ” 和 “ 禁止 ” 3 种 类 型 © ToolBarInputField 


SA ToolBarLinkChoice 


© contextMenuld: 设置 上 下 文 菜 单 的 唯一 标识 1 mies BarLinkToAction 
design: 用 于 指定 工具 栏 的 设计 样式 ， 默 认 有 “emphasized” a ee 
Fil “standard” 两 种 样式 。 去 ToolearToggleButton 
è enabled; 可 绑 定 上 下 文 的 属性 。 控 制 元 素 是 否 可 用 。 

e itemOverFlow: 控制 是 否 允 许 工 具 栏 中 的 对 象 超过 边界 。 
tooltip: 控制 提示 消息 的 显示 文本 。 

visible; 可 绑 定 上 下 文 的 属性 。 控 制 元 素 是 否 可 见 。 

e wrapping: 用 于 说 明 工 具 栏 中 的 元 素 是 否 会 自动 折 对 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “ Out- 
line” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插 入 子 对 象 ， 选 择 工 具 栏 类 型 ， 输 入 ID 
ZEK, Pii “OK” FZE, WME 4-84 所 示 。 

2) MERWE, TREEREN, STAHA, HE, WREEF, H 
会 是 页 面 上 的 一 个 空 党 。 右 击 “ToolBar” 工 具 栏 即 可 添加 工具 栏 支持 的 子 元 素 ， 如 图 4-85 
所 示 。 其 中 ， 第 一 个 选项 是 添加 工具 栏 子 元 素 ; 第 二 个 是 添加 欧 入 的 容器 ， 里 面 可 以 继续 添 
加 任意 的 ULICR ; 第 三 个 菜单 是 添加 默认 在 工具 栏 中 靠 右 显 示 的 子 元 素 。 

3) 选择 “Insert ToolBarltem”， 在 弹出 的 对 话 框 中 即 可 选择 相应 的 元 素 ， 如 图 4- 86 
所 示 。 


图 4-83 工具 栏 的 子 元 素 


UI Element 


El CalendarPaginator 
ToolBarButton 

E ToolBarButtonChoice 

SF ToolBarDropDownByIndex 
SB ToolBarDropDownByKey 
© ToolBarlnputField 

SB ToolBarLinkChoice 

22 ToolBarLinkToAction 


a | | RootElement > 
ToolBarLinkToURL 
Insert ToolBarltem... TOTOR TARS 


a C Group r © ToolBarSeparator 
T Group Header [Header] Insert ToolBarfopin BToolBarloggleButton 
ToolBar [ToolBar] Insert ToolBarRightltem... = 


图 4-84 添加 后 的 效果 图 4-85 添加 子 元 素 的 菜单 选择 ”图 4-86 选择 子 元 素 的 类 型 


4) 选择 添加 一 个 工具 栏 按钮 ， 单 击 “OK” 按 钮 ， 按 照 同 样 的 操作 再 次 添加 一 个 按钮 ， 
如 图 4-87 所 示 。 
5) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 就 能 看 到 实际 的 运行 效果 ， 如 图 4-88 所 示 。 
a RootElement 


4 7] Group 
T Group_Header [Header] 


= Teor [ToolBar] 


图 4-87 添加 后 的 效果 图 4-88 ”运行 效果 


170 


4.2.7 超 链接 


Web Dynpro 中 的 超 链接 包含 两 种 类 型 : “LinkToAction” 和 “LinkToURL”， 两 种 链接 都 
是 以 网 页 链接 的 形式 〈 默 认为 蓝 色 带 下 画 线 字体 ) 在 视图 中 展示 。 不 同 的 是 动作 链接 在 用 
户 单 击 后 会 触发 相应 的 动作 ，URL 链接 则 是 直接 打开 属性 中 配置 的 网 页 超 链 接 (更 像 是 
HTML 中 的 一 个 链接 ) 。 

不 管 是 哪 种 链接 形式 ， 都 包含 了 下 列 共 同属 性 。 

1) ActivateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

2) ContextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ” 
3 种 类 型 。 

3) ContextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

4) controlMenuDisabling: 控制 菜单 是 否 可 用 。 

5) Design, 控制 链接 文本 的 显示 风格 ,默认 有 标准 显示 和 增强 显示 两 种 类 型 ， 其 中 增 
强 类 型 即 为 文本 加 粗 显示 。 

6) Enabled: 控制 元 素 是 否 可 用 。 

7) Hotkey; 设置 指定 键盘 组 合作 为 快捷 键 使 用 ， 必 须 从 下 拉 菜 单 中 选择 ,不 可 自 定义 
设置 。 

8) imageFirst: 控制 显示 的 链接 图 标 是 否 位 于 文本 前 面 ， 布 尔 型 属性 。 

9) imageHeight: 控制 链接 图 标的 高 度 。 

10) imageSource: 控制 链接 图 标的 来 源 (文件 目录 位 置 ) 。 

11) imageWidth: 控制 链接 图 标的 宽度 。 

12) text: 控制 链接 的 显示 文本 。 

13) textDirection: 控制 链接 文本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 
往 右 和 从 右 往 左 。 

14) tooltip, 控制 提示 消息 的 显示 文本 (对 应 老 版 本 中 的 “imageAlt” 属 性 ) 。 

15) type: 控制 链接 的 显示 风格 ,默认 有 以 下 4 种 风格 : 

o 功能 型 : 显示 默认 的 链接 风格 ， 默 认为 蓝 色 带 下 画 线 文本 。 

e 导航 型 : 显示 为 已 访问 过 的 链接 颜色 ， 文 本 带 下 画 线 。 

o 报告 型 : 显示 默认 的 链接 风格 ， 但 文本 不 带 下 画 线 。 

e 结果 型 : 显示 为 已 访问 过 的 链接 颜色 ， 但 文本 不 带 下 画 线 。 

16) visible; 控制 元 素 是 否 可 见 。 

17) wrapping: 控制 文本 是 否 可 折 和 县 (页 面 宽度 不 足 时 将 文本 自动 换行 ) 。 

而 两 种 链接 又 分 别 有 一 些 特有 的 属性 。 其 中 动作 链接 包含 以 下 特有 属性 。 

e。“onAction” 事 件 : 用 于 用 户 单 击 链接 时 触发 的 服务 需 端 事件 处 理 需 。 

URL 链接 包含 以 下 特有 属性 。 

© reference; 控制 单 击 打开 的 URL 地 址 。 

e target: 控制 弹出 页 面 的 具体 位 置 ， 如 可 以 使 弹出 页 面 在 指定 的 窗口 中 打开 。 

开发 实例 : 

1) 在 任意 视图 中 创建 一 个 动作 链接 ,并 调整 其 属性 ,将 “Design” 修 改 为 “empbh- 
sized”， 将 “imageFirst” 修 改 为 “false”，“imageSource” 选 择 SAP 标准 图 标 中 的 “s_b_ 
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urls. gif” ， 将 “text” 修 改 为 “动作 链接 示例 ”， 如 图 4-89 所 示 。 
2) 编译 、 运 行 后 的 效果 如 图 4-90 所 示 。 


== LinkToAction 

design emphasized 
enabled true 
LayoutData hotkey none* 
imageFirst false 


imageHeight 


imageSource ~sapicons/s_b_urls.gif 


imageWidth 

text 动作 链接 示例 
textDirection inherit* 
tooltip ® 

type function* 
visible visible* 


wrapping false 动作 链接 示例 图 


图 4-89 修改 属性 图 4-90 运行 效果 


3) 在 任意 视图 中 创建 一 个 URL 链接 ， 并 调整 其 属性 , “imageSource” 选 择 SAP 标准 图 
标 中 的 “s_b_anwe. gif”， 将 “imageWidth” 修 改 为 “30px”， 将 “reference” 修改 为 需要 访 


问 的 网 页 地 址 ， 将 “text” 修 改 为 “URL 链接 ”， 如 图 4-91 所 示 。 
4) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 就 能 看 到 实际 的 效果 ， 如 图 4-92 所 示 。 

“@ LinkTOURL 
imageFirst true 

General imageHeight 

LayoutData imageSource ~sapicons/s_b_anwe.gif 
imageWidth 30px 

| reference http://www.sapeyes.com 

target 
text URL 链 接 
textDirection ltr 
tooltip ® 
type navigation* 本 
visible visible" OHS 


图 4-91 修改 属性 图 4-92 ”运行 效果 
4.2.8 选项 卡 集 


Web Dynpro 中 的 选项 卡 集 元 素 (AE) 实际 上 是 一 系列 选项 卡 的 容 需 或 者 集合 ， 它 的 
子 元 素 只 能 是 选项 卡 (Tab)。 它 包含 了 下 列 属 性 。 

1) accessibilityDescription: 设置 消息 提示 和 描述 等 文本 是 否 在 用 户 选中 整个 选项 卡 集 时 
显示 。 

2) ActivateAccessKey; 控制 是 否 允 许 快捷 键 (使 用 “Alt” 刍 与 首 字母 触发 默认 事件 ) 。 

3) ContextMenuBehaviour; 控制 上 下 文 菜单 行为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 

4) ContextMenuld; 上 下 文 菜单 唯一 标识 。 

5) enabled; 控制 元 素 是 否 可 用 。 
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6) 
7) 


handleHotkeys; 设置 是 否 处 理 快 捷 键 触发 事件 。 
height; 控制 元 素 的 显示 高 度 。 

8) selectedTab; 控制 默认 选中 的 选项 卡 。 

9) selectionChangeBehaviour: 设置 选项 卡 切 换 时 是 否 自动 切换 选项 卡 集 的 首选 项 (lead 
selection) ， 有 自动 或 手动 两 个 选项 。 

10) tabAlignment: 设置 子 选 项 卡 大 小 的 调整 方式 ， 默 认 包 含 以 下 两 种 调整 方式 : 

e exact: 按照 子 选 项 卡 的 确切 大 小 进行 显示 。 

o fast, 人 允许 客户 端 更 有 效 地 显示 而 对 高 度 和 宽度 进行 优化 。 

11) tooltip: 控制 提示 消息 的 显示 文本 。 

12) visible: 控制 元 素 是 否 可 见 。 

13) width: 控制 元 素 的 显示 宽度 。 

选项 卡 集 默 认 有 以 下 两 个 动作 可 以 定义 并 触发 相应 事件 。 

e onClose: 当 单 击 选 项 卡 的 关闭 按钮 时 触发 相应 事件 。 

e onSelect: 当 用 户 进 行 选项 卡 切 换 时 触发 相应 的 事件 。 

作为 选项 卡 集 唯一 可 用 的 子 元 素 的 选项 卡 ， 它 包含 了 下 列 

e closeable: 控制 选项 卡 是 否 可 以 被 用 户 关 闭 。 

e enabled; 控制 元 素 是 否 可 用 。 

e hasContextPadding: 控制 选项 卡 页 面 内 部 是 否 有 间距 ， 类 似 Word 文档 中 的 页 边 距 。 

e visibility, 控制 元 素 是 否 可 见 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 ) ， 首 先 需要 
上 下 文 的 定义 。 创 建 一 个 集合 属性 为 “1…1” 的 结 点 ， 随 后 创建 员工 信息 相关 的 上 下 文 特 
性 ， 见 表 4-2。 


属性 。 


表 4-2 员工 信息 相关 的 上 下 文 特性 
特性 ID 名 称 特性 描述 特性 类 型 
PrInfo Node 人 员 信 息 结 点 
id 用 户 ID 字符 串 
name 姓名 字符 串 
age 年 龄 整数 类 型 
dept 部 门 字符 串 
createDate 创建 日 期 日 期 类 型 

2) 创建 完毕 后 ,保存 所 有 修改 ， 如 图 4-93 所 示 。 z content] 

3) 右 击 “Outline” 元 素 清单 中 的 “RootElement” 根 结 点 ， Oo nace 
选择 插入 子 对 象 ， 选择 “TabStrip” 选 项 卡 集 类 型 ， 输 入 ID 名 日 “createDete 
称 ， 单 击 “OK” 按 钮 ， 如 图 4-94 所 示 。 

4) 如 果 不 添 加 选项 卡 ， 选 项 卡 集 只 是 一 个 空 的 容器 ， 在 ets 

pa 


“Outline” P A h MRE, WERE “Insert Tab”, YI 4-95 


所 示 。 


4-93 ”特性 清单 


5) 操作 两 次 ， 共 新 增 “Tab” 和 “Tab1” 两 个 选项 卡 ， 如 图 4-96 所 示 。 
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Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] [All] [E TabStrip 
Action Active Components El TextEdit 
Complex Adobe El TextView 
Graphic Analytics @ TimedTrigger 
Integration Business Graphics ToggleButton 


Layout Business Intelligence ras ToggleLink 

Menu Calendar == ToolBar 

Selection Mobile Add-Ons =P ToolBarButton 

Text Office Integration 2 ToolBarButtonChoice 
Toolbar Pattern Development tF ToolBarDropDownBylndex 
Realtime Messaging TẸ ToolBarDropDownByKey 
Standard = ToolBarInputField 
ToolBarLinkChoice 

S22 ToolBarLinkToAction 


Sy ToolBarLinkToURL 


ID TabStrip 


BS 


4-94 ”选择 元 素 类 型 


Insert Tab 
of Cut Ctrl+X Ey Tabstrip 
Copy Ctrl+C > a Tab 
> Paste Ctrl+V > B Tabi 
图 4-95 添加 选项 卡 的 菜单 选择 图 4-96 添加 后 效果 


6) 将 选项 卡 的 “text” 属 性 分 别 修改 为 “个 人 信息 概览 ”和 “个 人 信息 明细 ”， 如 


图 4-97 所 示 。 
| onere | 


图 4-97 运行 效果 
7) 在 第 一 个 选项 卡 中 添加 一 个 标签 和 1 个 文本 框 ， 如 图 4-98 所 示 。 
/个 人 们 息 明 细 | 


图 4-98 ”预览 效果 
8) 右 击 第 二 个 选项 卡 中 的 “Tabl _Content” 容 器 并 选择 “Apply Template”， 选 择 
“Form” 表 单 ， 单 击 “Next” 按 钮 ， 如 图 4-99 所 示 。 
9) 选择 表单 中 需要 使 用 的 上 下 文 特性 ， 单 击 “Next” 按 钮 ， 如 图 4-100 所 示 。 
10) 选择 页 面 元 素 的 具体 类 型 ， 其 中 “dept” 部 门 使 用 “DropDownByKey” 下 拉 列 表 ， 
单 击 “Finish” 按 钮 ， 如 图 4-101 所 示 。 
11) 在 选项 卡 中 生成 了 对 应 的 表单 页 面 ， 如 图 4-102 所 示 。 
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一 一 nl 
Apply Template - 
i 
Select Template 


Creates a form in the view 


Template Instance Name Form 


Available Templates: 


E Action Button Creates a form in the view 
Form | 


Table 


(O Context| 
VA Prinfo 


V| @ age 
| W| B createDate 
目 dept 


® = (eet Gre) "ew | TE 
B name 


图 4-99 选择 模板 类 型 图 4-100 选择 对 应 的 上 下 文 
Name Attribute Editor Bound Prop... 
id id (Prinfo.id) InputField value ID: 
name name (Prinfo.name) InputField value 姓名 : 
age age (Prinfo.age) InputField value ER: 
dept "dept Prinfo.dept) DropDownBy.. selectedKey ad 
创建 日 期 :  [@createDate 


createDate createDate (Prinfo.cre... InputField 


图 4-101 调整 元 素 类 型 和 位 置 图 4-102 ”预览 效果 


12) 如 果 将 第 一 个 选项 卡 的 可 关闭 属性 改 为 “true”， 则 用 户 就 可 以 手动 关闭 对 应 选项 
卡 ， 如 图 4-103 所 示 。 

13) 在 配置 过 程 中 也 可 以 看 到 ， 其 实 选项 卡 对 应 的 也 只 是 一 个 透明 容器 ， 所 以 选项 卡 
中 的 页 面 元 素 调整 就 可 以 参考 其 他 的 元 素 介绍 自由 地 进行 配置 了 ， 如 图 4-104 所 示 。 


a Pj TabStrip 
4 Ñ Tab 
—! 不 人 信息 明细 T Tab_Header [Header] 
[C Tab_Content) 
; @name iie :| 
= [TransparentContainer | 


BS 


图 4-103 运行 效果 4-104 添加 后 的 效果 


4.2.9 FER 


托盘 是 一 个 类 似 于 组 的 UI 元 素 ， 它 可 以 将 若干 的 元 素 包 含 在 特定 区 域 中 ， 并 且 赋 予 一 
个 通用 的 标题 ， 但 是 它 比 组 元 素 稍 微 复 杂 一 些 ， 确 切 地 说 ， 是 拥有 更 多 的 功能 。 首 先 ， 最 直 
观 的 区 别 就 是 托盘 可 以 被 展开 或 收 起 ， 收 起 时 仅 显 示 托 盘 的 标题 部 分 ; 接着 托盘 标题 右 侧 可 
以 定义 一 个 菜单 按钮 进行 功能 的 自 定义 。 托 盘 中 还 可 以 定义 工具 栏 。 

托盘 包含 以 下 属性 。 

1) layout; 控制 元 素 内 部 的 布局 类 型 。 

2) accessibilityDescription: 设置 消息 提示 和 描述 等 文本 是 否 在 用 户 选 中 整个 选项 卡 集 时 
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显示 。 

3) activateAccessKey: 设置 是 否 允 许 快 捷 键 (使 用 “Alt” 刍 与 首 字母 触发 默认 事件 ) 。 

4) contextMenuBehaviour: 设置 上 下 文 菜 单行 为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止” 
3 种 类 型 。 

5) contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

6) defaultButtonId: 用 于 控制 默认 对 应 按钮 的 标识 。 

7) design; 控制 托盘 元 素 整 体 的 样式 ,默认 有 以 下 3 种 样式 可 以 选择 。 

efil: 托盘 的 内 容 区 域 会 显示 默认 的 背景 颜色 。 

e plain: 托盘 的 内 容 区 域 会 显示 白色 的 背景 颜色 并 带 有 边框 。 

e transparent: 托盘 的 内 容 区 域 背景 是 透明 的 ， 并 且 内 容 区 域 周围 没有 边框 。 

8) enabled; 控制 元 素 是 否 可 用 。 

9) expandable; 控制 托盘 是 否 可 以 展开 或 收 起 。 

10) expended: 控制 托盘 的 默认 状态 是 否 为 展开 。 

11) hanlesHotkeys: 控制 托盘 是 否 作为 一 个 独立 的 容器 来 响应 定义 的 快捷 键 事件 。 

12) hasContextPadding: 控制 托盘 的 内 容 区 域内 部 是 否 与 边框 有 边 距 。 

13) height: 控制 托盘 的 高 度 。 

14) scrollingMode : 控制 滚动 条 是 否 在 内 容 区 域 的 容器 中 可 见 。 

e auto: 容器 中 的 滚动 条 会 自动 被 激活 

e both: 横向 和 纵向 的 滚动 条 默认 已 激活 

e none: 不 允许 出 现 滚动 条 

15) tooltip; 控制 提示 消息 的 显示 文本 。 

16) visible 控制 元 素 是 否 可 见 。 

17) width, 控制 元 素 的 显示 宽度 。 

18) onToggle 事件 : 托盘 的 默认 事件 ， 会 在 用 户 展开 或 收 起 托盘 时 触发 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “ Out- 
line” 元 素 清 单 中 的 “RootElement” 根 结 点 ， 选 择 搬入 子 对 象 ， 选 择 “Tray” 托 盘 类 型 ， 输 
AID AFK, 单 击 “OK” 按 钮 ， 如 图 4-105 所 示 。 


New UI Ele 
Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 
[All] 全 | | [All 全 TransparentContainer 全 
| Action Active Components | TTray 
Complex Adobe 3 图 Tree 
Graphic =|| | Analytics E| TriStateCheckBox 
Integration Business Graphics & ValueComparison 
Layout Business Intelligence E ViewContainerUlElement 回 
Menu Calendar WebWidget 
Selection ~ Mobile Add-Ons ~| |< malls J 上 
ID Trayl 
图 4-105 ”选择 元 素 类 型 
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2) 右 击 “Outline” 中 的 托盘 ， 可 以 看 到 托盘 中 可 添加 的 一 些 特殊 对 象 ， 如 图 4-106 
所 示 。 

3) 依次 添加 工具 栏 、 弹 出 菜单 和 透明 容器 后 ， 就 能 实现 一 个 相对 复杂 的 需求 ， 如 
图 4-107 所 示 。 


a E Tray 
T Header [Header] 
Expand/Collapse 4 = ToolBar [ToolBar] 
=P ToolBarButton 
ig ToolBarDropDownByKey 


Insert Child... 


Insert Header 4 E> PopupMenu [PopupMenu] 


Insert PopupMenu —& MenuActionltem 
Insert ToolBar C] TransparentContainer1 


图 4-106 托盘 的 子 元 素 图 4-107 添加 后 的 效果 


4) 编译 、 运 行 后 ， 就 能 看 到 实际 的 视图 效果 ， 如 图 4-108 所 示 。 


| 托盘 标题 EN 


RS EE 
| 


图 4-108 运行 效果 
4.2.10 ”消息 区 域 


消息 区 域 是 Web Dynpro 用 于 定义 消息 显示 的 具体 位 置 的 元 素 ， 包 括 报 错 消 息 、 警 告 消 
息 和 成 功 消息 等 消息 管理 器 发 布 的 所 有 消息 ， 同 时 在 同一 个 视图 实例 中 也 仅 会 存在 一 个 消息 
区 域 的 实例 。 如 果 程 序 中 未 定义 消息 区 域 ， 则 消息 提醒 的 位 置 无 法 统一 ， 当 页 面 元 素 过 多 或 
表单 过 长 时 ， 用 户 很 可 能 会 没 注意 操作 时 返回 的 消息 ， 从 而 增加 用 户 操作 难度 以 及 运 维 人 员 
的 工作 量 。 
消息 区 域 元 素 包 含 下 列 属性 。 
© contextMenuBehaviour; 设置 上 下 文 菜 单行 为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 
e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 
e design, 控制 链接 文本 的 显示 风格 ， 默 认 有 标准 显示 和 增强 显示 两 种 类 型 ， 其 中 增强 
类 型 即 为 文本 加 粗 显 示 。 
è enabled; 控制 元 素 是 否 可 用 。 
e maxVisibleMessages: 控制 消息 区 域 元 素 能 够 显示 的 最 大 消息 数 ， 默 认 值 为 “0” 表 示 
没有 限制 。 
e tooltip: 控制 提示 消息 的 显示 文本 。 
e visible: 控制 元 素 是 否 可 见 。 
与 其 他 Web Dynpro 元 素 不 同 的 是 ， 消 息 区 域 的 “enabled” 属 性 虽然 可 以 绑 定 上 下 文 特 
性 ,但 只 能 绑 定 只 读 状态 的 上 下 文 ， 且 值 为 “true”; 而 消息 区 域 的 “visible” 属 性 虽然 也 可 
以 绑 定 上 和 下文 特 性 ， 但 也 只 能 绑 定 只 读 属 性 的 特性 ， 而 且 值 不 能 设置 为 “none” 或 
“blank” 。 
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开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步 又) ， 右 击 “Out- 
line” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 搬 和 信子 对 象 ， 选 择 “MessageArea”， 输 入 
ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-109 所 示 。 


Create a new UI element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[AI [AI | Bi MessageArea 
Action Active Components 上 MessageBasedTrigger 
Complex Adobe > NavigationList 
Graphic Analytics || | SP Network 
Integration Business Graphics || | E OfficeControl 
Layout Business Intelligence E] PageHeader 
Menu Calendar J| | E PatternTabStrip 
Selection Mobile Add-Ons i PatternTray 


Text Office Integration Ana Dhan ntndinntne 


ID MessageAreal 


R| 4-109 选择 元 素 类 型 


2) 在 视图 中 添加 一 个 按钮 ， 用 于 打印 消息 。 将 按钮 的 “text” 文 本 属性 修改 为 “打印 
消息 ”( 见 图 4-110) ， 在 按钮 的 事件 中 新 建 一 个 动作 ， 并 添加 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess("Report Success!" ) ; 


3) 保存 所 有 修改 ， 并 重新 编译 、 运 行 ， 运 行 效 果 如 图 4-111 所 示 。 
4) 单 击 “ 打 印 消息 ”按钮 ， 消 息 显 示 在 顶端 ， 如 图 4-112 所 示 。 


国 Report Success! 
> CECA free 


图 4-110 预览 效果 图 4-111 运行 效果 K 4-112 单 击 “打印 消息 ”按钮 效果 


5) 接着 回 到 视图 中 ， 并 改变 消息 区 域 的 位 置 ， 调 整 到 按钮 后 面 ， 如 图 4-113 所 示 。 

6) 在 开发 工具 中 的 视图 预览 效果 ， 如 图 4-114 所 示 。 

7) 再 次 编译 、 运 行 之 后 ， 单 击 “ 打 印 消息 ”按钮 ， 消 息 显 示 在 按钮 下 方 (在 不 同 的 开 
发 程序 中 ， 会 根据 实际 容器 的 布局 显示 在 后 面 或 下 方 ) ， 如 图 4-115 所 示 。 


[] RootElement 


CHEM A | 


im Button 
BF = [|] MessageArea Report Success! 
图 4-113 调整 后 的 效果 图 4-114 预览 效果 4-115 ”运行 效果 


4.2.11 表单 


在 介绍 了 一 些 常 用 的 简单 元 素 之 后 ， 当 开发 人 员 将 上 述 元 素 组 合 在 一 起 展现 在 前 台 时 ， 
就 形成 了 表单 。 表 单 是 需要 有 样式 的 ， 这 个 可 以 通过 不 同 的 布局 来 实现 。 与 单个 元 素 创建 并 
构建 表单 不 同 ，Web Dynpro 同样 提供 了 一 个 向 导 功 能 用 于 表单 的 快速 创建 。 在 熟悉 以 后 ， 
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开发 人 员 也 可 以 根据 实际 需要 进行 表单 的 手动 创建 。 

严格 来 说 ， 表 单 并 不 属于 Web Dynpro 的 界面 元 素 ， 它 其 实 是 从 业务 角度 的 一 个 定义 ， 
所 以 在 Web Dynpro 中 ， 一 个 表单 并 没有 固定 属性 。 它 可 以 根据 需要 放 和 不同 的 容器 中 ， 如 
透明 容器 、 组 或 托盘 等 元 素 ， 根据 这 些 特定 的 容器 ， 表 单 也 可 以 进行 一 些 特殊 的 设置 和 


调整 。 
开发 实例 ; 


假设 需要 创建 一 个 表单 用 于 提交 员工 的 基本 信息 。 
1) 在 创建 一 个 视图 后 ， 首 先 需 要 上 下 文 的 定义 。 创 建 一 个 集合 属性 为 “1…1” 的 结 


的 


点 ， 然 后 创建 与 员工 信息 相关 的 上 下 文 特性 ， 见 表 4-3。 


表 4-3 员工 信息 相关 的 上 下 文 特性 
特性 ID 名 称 特性 描述 特性 类 型 
PrInfo Node 人 员 信 息 结 点 
id 用 户 ID 字符 串 
naie 姓名 FHR 
age 年 龄 整数 类 型 
dept 部 门 字符 串 
createDate 创建 日 期 日 期 类 型 
2) 创建 完毕 后 ， 保 存 所 有 修改 ， 如 图 4-116 所 示 。 4 (© Context] 
3) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参 A 
考 之 前 章 节 步 又 ) ,> 右 击 “Outline” 元 素 清 单 中 的 “RootEle- B createDate 
ment” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 “Group”， 输 入 ID 名 称 
“V01_Gp”， 单 击 “OK” 按 钮 ， 如 图 4-117 所 示 。 B name 


4) 完成 创建 后 ， 在 “Outline” 中 多 了 一 个 组 的 元 素 ， 如 


图 4-118 所 示 。 


New UI Element 3 "7 


Al4-116 ”添加 特性 后 的 效果 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] [All] [EZ] Group |- 
Action Active Components É HierarchicalCalendarMonthView 
Complex Adobe Q HorizontalContextualPanel 
Graphic Analytics — HorizontalGutter 
Integration Business Graphics [_]IFrame 
Layout Business Intelligence B Image T 
Menu Calendar ee InputField 三 
Selection Mobile Add-Ons g InputTokenizer = 
| Text Office Integration E] InteractiveForm 
Toolbar Pattern Development = InvisibleElement 
Realtime Messaging EH ItemListBox 
Standard T Label 
E] Legend 
“tM LinkChoice 
== LinkToAction S 
i | 
ID Group E _ p 


R| 4-117 ”选择 元 素 类 型 
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5) Aik “VOl _Gp” 并 选择 “Apply Template” ; a [| RootElement 
KEE “Form” RÉ, Mi “Next” 4, 40 4 (| VOl_Gp 


Al 4-119 所 示 。 T Group Header [Header] 
6) 随后 选择 表单 中 需要 使 用 的 上 下 文 特性 ， 图 4-118 添加 后 的 效果 


单 击 “Next” 按 钮 ， 如 图 4-120 所 示 。 


0 Apply Template Crima) 


Select Template 


Creates a form in the view 


Template Instance Name Form 


Available Templates: 


Action Button Creates a form in the view 
Form | 
Table 


E El) E 


图 4-119 选择 模板 类 型 


7) 选择 页 面 元 素 的 具体 类 型 ， 其 中 “dept” 部 门 使 用 “DropDownByKey” 下 拉 列 表 ， 
单 击 “Finish” 按 钮 ， 如 图 4-121 所 示 。 


Name Attribute Editor Bound Prop... 
4 WE Prinfo id id (Prinfo.id) InputField value 
v| B age name name (Prinfo.name) InputField value 
v| B createDate age age (Prinfo.age) InputField value 
EENT [dept dept (Prinfo.dept) DropDownBy.. selectedKey | 
= £ p createDate createDate (Prinfo.cre.. InputField value 
图 4-120 选择 对 应 特性 图 4-121 ”调整 元 素 类 型 和 位 置 


8) 通过 向 导 添 加 表单 后 ,会 在 “Outline” 的 清单 中 看 到 一 个 自动 生成 的 透明 容器 ， 里 
面包 含 了 刚才 选择 创建 的 标签 :和 输入 框 等 各 种 元 素 ， 如 图 4-122 所 示 。 

9) 修改 组 的 属性 ， 设 置 它 的 “width” 宽度 为 100% ， 定 义 “Caption” 标题 内 容 “ 人 员 
言 息 ”， 如 图 4-123 所 示 。 


| 人员 信息 
id @id 
name: @name 
[EZ VO1_Gp| zr @age 
T Group_Header [Header] bes = 
i | createDate: @createDate M 
> [| TransContainer_O 二 一 
图 4-122 添加 后 的 效果 图 4-123 ”预览 效果 


180 


10) 进一步 优化 页 面 布局 ， 调 整 透 明 容 需 的 宽度 ， 也 可 根据 实际 需求 添加 “提交 ” 按 
钮 ， 如 图 4-124 所 示 。 


人 员 信 息 

ID: @id 

Hee: @name 

Fi @age El 

部 门 : pa 

创建 日 期 : @createDate [Eal 
Ez 


图 4-124 预览 效果 


11) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 就 能 看 到 实际 的 效果 ， 如 图 4-125 所 示 。 


| 人 员 信 息 
ID: 
姓 各 : 
sR: 0E 
部 门 : © 
(me) 


43 复杂 元 素 


4.3.1 复 选 框 组 


复 选 框 组 (CheckBoxGroup) 是 多 个 复 选 框 的 一 个 集合 ， 并 以 一 个 表格 的 方式 将 若干 复 
选 框 在 视图 中 进行 显示 ， 用 户 可 以 从 这 个 集合 中 勾 选 对 应 的 条 目 。 与 单 选 按钮 组 不 同 的 是 ， 
复 选 框 组 中 可 以 进行 条 目的 多 选 。 它 包含 了 下 列 属性 。 

© accessibilityDescription; 设置 复 选 框 组 中 的 文本 是 否 在 用 户 选中 整个 元 素 时 显示 。 

e activateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

e colCount: 控制 每 一 行 显示 的 复 选 框 的 个 数 。 

© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 

种 类 型 。 

e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 

e enabled: 控制 元 素 是 否 可 用 。 

e explanation: 设置 元 素 的 解释 文本 ， 设 置 后 元 素 文本 下 方 会 出 现 一 条 绿色 的 下 画 线 。 

当 鼠 标 悬 停 在 文本 上 时 ， 会 弹出 解释 文本 的 说 明 。 

è readOnly: 控制 元 素 是 否 只 读 。 

estate: 控制 元 素 的 显示 状态 ， 默 认 有 “normal” 和 “required” 两 种 状态 。 在 选择 

“required” 后 ， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ， 但 逻辑 控制 仍 需 要 编写 相关 


代码 。 
e textDirection: 控制 链接 文本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 往 右 
和 从 右 往 左 。 


o texts: 控制 复 选 框 组 的 显示 文本 ， 不 能 人 硬 编码 设置 ， 只 能 绑 定 选择 属性 为 “0…n” 或 
“1…n” 的 上 下 文 结 点 中 的 特性 。 
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e tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

e width, 控制 元 素 的 显示 宽度 。 

e onToggle FAF: 复 选 框 组 的 默认 事件 ,会 在 用 户 单 击 复 选 框 时 触发 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “Out- 
line” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 “CheckBoxGroup” 复 
选 框 组 类 型 ,输入 ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-126 所 示 。 


New UI Element 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
fall] + | | [All] a| | Br CheckBoxGroup < 
Action Active Components Q ContextualPanel 
Complex Adobe B DateNavigator 国 
Graphic Analytics 图 DropDownByIndex 
Integration Business Graphics E DropDownByKey 
Layout Business Intelligence 和 DropTarget 
Menu Calendar E Explanation 
p Selection Mobile Add-Ons E3 FileDownload 
Text 5 Office Integration Ri jopon logat = 


ID CheckBoxGroup 


R| 4-126 ”选择 元 素 类 型 


2) 创建 对 应 的 上 下 文 结 点 以 及 特性 ， 如 图 4-127 所 示 。 
3) 注意 结 点 的 属性 中 的 选择 属性 必须 是 “0 …n” 或 “1 …n”， 
允许 与 之 绑 定 的 视图 元 素 选择 多 个 条 目 ， 如 图 4-128 所 示 。 


Collection Cardinality ”CO.n > 
Initialize Lead Selection true 


a DD checkbox| 
text 
即 


4-127 HEWA 


a 


checkbox 


Name 
Selection Cardinality 
Singleton 


Tn 


true 
结 点 的 属性 修改 
4) 进入 Java 编辑 器 ， 编 写 初 始 化 代码 ， 录 入 一 些 模拟 选项 : 


ICheckboxElement createAndAddCheckboxElement = wdContext. nodeCheckbox( ) 
. createAndAddCheckboxElement( ) ;// 创 建 选项 
wdContext. nodeCheckbox( ). setSelected(0, true) ;// 选 项 是 否 被 选中 
createAndAddCheckboxElement. setText(" 费用 报销 " ) ;// 备 注 
createAndAddCheckboxElement = wdContext. nodeCheckbox( ) 
. create AndAddCheckboxElement( ) ; 
createAndAddCheckboxElement. setText(" 请假 申请 " ) ; 
createAndAddCheckboxElement = wdContext. nodeCheckbox( ) 
. createAndAddCheckboxElement( ) ; 
createAndAddCheckboxElement. setText(" 费 用 立项 " ) ; 


5) 选择 创建 完成 的 复 选 框 组 ,将 “text” 属 性 与 上 下 文 的 特性 进行 绑 定 ， 如 图 4-129 
所 示 。 
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器 


4-128 


6) 绑 定 上 下 文 后 ， 创 建 一 个 默认 动作 “MakeSelection”， 对 用 户 的 动作 进行 响应 ， 如 
图 4-130 所 示 。 


4 Events 


texts B checkbox.text onToggle MakeSelection 
图 4-129 ”修改 文本 属性 图 4-130 修改 事件 属性 


7) 在 创建 动作 时 添加 两 个 参数 ， 参 数 类 型 分 别 为 布尔 型 和 整数 型 ， 用 于 区 分 是 否 勾 选 
以 及 勾 选 条 日 的 索引 ， 如 图 4-131 所 示 。 


Details | Parameters | 


Name Type 
checked boolean 
index integer 


图 4-131 添加 方法 中 的 参数 


8 ) 保 存 所 有 修 改 A 击 “ Outline” 4 jonToggle ——|— IMakeSeledtion 
POEN See checked} | 3" ced 
1A 单 中 的 RZ 选 HE 组 9 选 择 Parameter [index] 


Mapping” (如 果 在 创建 动作 时 不 添加 对 应 
参数 ， 则 无 法 进行 映射 ) ， 将 复 选 框 组 所 e 
选 的 关键 字 与 创建 的 动作 中 的 参数 进行 映射 ， 如 图 4-132 所 示 。 
9) 保存 所 有 修改 ， 随 后 进入 Java 编辑 器 ， 在 动作 对 应 的 方法 中 添加 以 下 代码 


wdComponentAPI. getMessageManager( ). reportSuccess( checked); /打印 传递 的 选中 参数 
wdComponentAPI. getMessageManager( ). reportSuccess( index) ; 上 /打印 当前 元 素 的 索引 


10) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 即 可 进行 匀 选 动作 的 测试 ， 如 图 4-133 所 示 。 

11) 在 匀 选 了 复 选 框 之 后 ， 消 息 区 域 中 也 会 打印 出 对 应 的 提示 消息 。 此 例子 中 的 消息 
分 别 表示 已 勾 选 和 勾 选 的 索引 。 索 引 序号 是 从 “0” 开 始 计算 ， 而 图 4-133 最 后 勾 选 的 是 第 
二 个 复 选 框 ， 所 以 在 图 4-134 中 看 到 的 索引 是 “1”， 如 图 4-134 所 示 。 


[| 费用 立项 true 
vii 


图 4-134 选择 后 的 效果 


4.3.2 单 选 按钮 组 


单 选 按钮 组 ( RadioButtonGroupByKey) 是 将 若干 单 选 按钮 放 和 人 一 个 表 中 合成 的 一 个 元 
素 。 与 复 选 框 组 不 同 的 是 ， 单 选 按钮 组 只 允许 选中 一 个 条 目 。 它 包含 下 列 属 性 。 

e accessibilityDescription; 设置 单 选 按钮 组 中 的 文本 是 否 在 用 户 选 中 整个 元 素 时 显示 。 

e activateAccessKey: 设置 是 否 允 许 快 捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

e colCount: 控制 每 一 行 显示 的 单 选 按钮 的 个 数 。 

© contextMenuBehaviour; 设置 上 下 文 菜 单行 为 ， 默认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 

种 类 型 。 
è contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 
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è enabled; 控制 元 素 是 否 可 用 。 

e explanation, 设置 元 素 的 解释 文本 ， 设 置 后 元 素 文 本 下 方 会 出 现 一 条 绿色 的 下 画 线 。 
当 和 鼠标 有 甚 停 在 文本 上 时 ,会 弹出 解释 文本 的 说 明 。 

e readOnly: 控制 元 素 是 否 只 读 。 

e selectedKey: 指定 上 下 文 特性 用 于 存放 当前 选中 的 条 目的 关键 字 ， 必 须 绑 定 上 下 文 。 

estate: 控制 元 素 的 显示 状态 ， 默认 有 “normal” 和 “required” 两 种 状态 。 在 选择 
“required” 后， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ,但 逻辑 控制 仍 需 要 编写 相关 
代码 。 

e textDirection: 控制 链接 文本 的 排列 顺序 ， 默 认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 往 右 
和 从 右 往 左 。 

e texts; 控制 单 选 按钮 组 的 显示 文本 ， 不 能 硬 编码 设置 ， 只 能 绑 定 选择 属性 为 “0 . - 
n” 或 “1 .. n” 的 上 下 文 结 点 中 的 特性 。 

e tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

e width, 控制 元 素 的 显示 宽度 。 

e onSelect 事件 : 单 选 按钮 组 的 默认 事件 ， 会 在 用 户 单 击 按钮 时 触发 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 ) ， 右 击 


“Outline” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 单 选 按钮 组 类 型 ， 
输入 ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-135 所 示 。 


部 门 


[Te 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] a| | [all] | | 89 RadioButtonGroupByKey ~ 
Action Active Components @) RFIDReader 
Complex Adobe baa RoadMap 
Graphic Analytics E RowRepeater 
Integration Business Graphics CI ScrollContainer 
Layout Business Intelligence E] SectionHeader E 
Menu Calendar Shuttle 
f Selection Mobile Add-Ons | Splitter 
Text S Office Integration £ anA ; a 


ID RadioButtonGroupByKey 


图 4-135 ”选择 元 素 类 型 


2) 打开 视图 的 上 下 文 页 签 ， 创 建 一 个 特性 ， 如 图 4-136 所 示 。 © Context 
3) 该 特性 使 用 的 是 mydynp04 中 创建 的 简单 类 型 ， 即 包含 了 3 个 [a dept] 
的 数据 和 一 条 空 数据 ， 如 图 4-137 所 示 。 图 4-136 特性 清单 


4) 随后 打开 单 选 按钮 组 的 属性 ， 将 “selectedKey” 属 性 与 上 下 


文 的 
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特性 进行 绑 定 ， 如 图 4-138 所 示 。 


© Manually 


Name: dept 


Type: |com.sap.demo.mydynp04.wd.ddic.Dept X Browse... 


图 4-137 创建 特性 
5) 绑 定 上 下 文 后 ， 创 建 一 个 默认 动作 “select” 对 用 户 的 动作 进行 响应 ， 如 图 4-139 所 示 。 


4 Events 


[selecedkcery edept | onSelect Select 
图 4-138 修改 属性 图 4-139 修改 事件 属性 


6) 在 创建 动作 时 添加 一 个 字符 串 类 型 的 参数 ， 用 于 记录 在 单 选 按 钮 组 中 选中 的 关键 
字 ， 如 图 4-140 所 示 。 


Details | Parameters | 


Name Type 
key string 


图 4-140 添加 参数 
7) 保存 所 有 修改 ， 右 击 “ Outline” 清 单 中 的 单 选 按 钮 组 ， 选 择 “ Parameter Mapping” 
(如 果 在 创建 动作 时 不 添加 对 应 参数 ， 则 无 法 进行 映射 )， 将 单 选 按 钮 组 所 选 的 关键 字 与 创 
建 的 动作 中 的 参数 进行 映射 ， 如 图 4-141 所 示 。 
12) 保存 所 有 修改 ， 随 后 进入 Java 编辑 器 在 动作 对 应 的 方法 中 添加 以 下 代码 : 


wdComponentAPI. getMessageManager( ). reportSuccess( "key:" + key) ; 上 /打印 选中 条 目 
的 关键 字 

wdComponentAPI. getMessageManager( ). reportSuccess( 

"dept:" +wdContext. currentContextElement( ). getDept( ) ) ; // 打 印 部 门 属性 


8) 保存 所 有 修改 ， 并 重新 编译 ， 运 行 之 后 即 可 进行 勾 选 动 作 的 测试 ， 如 图 4-142 
所 示 。 


“Ps | 
图 4-141 ”进行 参数 映射 图 4-142 运行 效果 


9) 在 选中 任 一 个 单 选 按钮 之 后 ， 消 息 区 域 中 也 会 打印 出 对 应 的 提示 [| 国 key02 | 
消息 。 此 例子 中 的 消息 分 别 表示 选中 的 关键 字 以 及 上 下 文 特性 的 对 应 值 。 | 国 dept:02 
由 于 在 简单 类 型 创建 中 “网 络 部 ”对 应 的 关键 字 是 “02”， 因 此 在 图 4_143 选择 
图 4-143 中 看 到 的 消息 均 为 “02”， 如 图 4-143 所 示 。 后 效果 


4.3.3 表格 


WD4J 技术 对 表格 做 了 更 充分 的 封装 ， 开 发 人 员 不 用 关心 表格 控件 本 身 ， 只 用 专注 于 绑 
定数 据 源 的 操作 。 表 格 设计 时 的 生成 建议 采用 模板 导航 自动 生成 ， 并 且 在 通过 上 下 文 结构 生 
成 表格 列 时 ， 也 可 以 根据 特性 的 类 型 选择 不 同 的 界面 元 素 进 行 个 性 化 显示 。 

表格 包含 以 下 属性 。 
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1) dataSource; 表格 对 应 的 上 下 文 结 点 数据 源 ， 必 须 绑 定 上 下 文 。 
2) fixedTableLayout: 控制 表格 布局 是 否 固定 ， 当 设置 为 “false” 时 ， 表 格 的 列 可 以 自 


由 拖 动 并 变更 位 置 。 


3) multiColSorting: 控制 是 否 支持 复合 列 排 序 。 
4) readOnly: 控制 表格 是 否 只 读 。 


5) rowSelectable; 控制 表格 行 项 


目 是 否 可 选 。 


6) scrollColCount: 控制 滚动 条 显示 的 列 数目 。 


7) selectionMode: 控制 表格 的 选择 模式 ， 默 认 有 “multi” 


“single” 4 个 类 型 。 
e multi: 表格 可 以 多 选 ， 并 且 默 
e multiNoLead; 表格 可 以 多 选 ， 


认 首 行 选中 。 
默认 不 选中 首 行 。 


e none; 表格 既 不 可 以 单 选 也 不 可 以 多 选 。 
e single: 表格 只 可 以 对 行 项 目 进行 单 选 。 
注 : 设置 为 “muli” 与 “multiNodeLead” 还 有 一 个 前 提 ， 就 是 绑 定 的 上 下 文 结 点 支持 


多 条 目的 选择 ， 即 结 点 的 可 选 属性 为 
8) visible: 控制 表格 是 否 可 见 。 
9) visibleRowCount; 表格 可 见 行 
10) width: 控制 表格 宽度 。 


“Q. n” 或 “Leen. 


项 目 数 。 


11) onColSelect 事件 : 选中 任意 列 时 触发 。 


12) onDrop 事件 : 拖 动 列 时 触发 


D 


13) onFiltet 事件 : 用 于 表格 过 滤 。 
14) onLeadSelect 事件 : 当 首选 项 发 生变 化 时 触发 ， 对 应 的 表格 行 项 目 只 能 单 选 。 
15) onSelect 事件 : 选中 行 项 目 时 触发 ， 对 应 的 表格 行 项 目 可 以 单 选 或 多 选 。 

16) onSort 事件 : 用 于 表格 排序 。 
下 面 通过 一 个 表格 的 开发 实例 , 来 了 解 表格 的 功能 和 实际 作用 。 


1. 创建 表格 
首先 在 视图 中 通过 应 用 模板 的 方 


式 创建 一 个 表格 。 


“multiNoLead” “none” 和 


1) 与 表单 的 创建 方式 相同 ， 表格 也 可 以 通过 应 用 模板 的 方式 进行 创建 。 首 先 在 视图 上 
下 文中 创建 一 个 集合 属性 为 “0.. n” 的 结 点 “PerLst”， 如 图 4-144 所 示 。 

2) 右 击 视图 中 的 “RootElement” 根 结 点 元 素 ， 选 择 “Apply Template”， 在 弹出 的 对 话 框 
中 选择 “Table” 表 格 类 型 ， 单 击 “Next” 按 钮 ， 然 后 选择 并 绑 定 上 下 文 数据 源 ， 如 图 4-145 


所 示 。 


站 口 PerLst 


age 


oO 


B createDate 
B dept 

Ð id 

B 


name 


图 4-144 特性 清单 
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4 EO Context] 


4 区 


CQ perLst 


v 


v 
vi 
v 
7i 


B age 


V| B createDate 


B dept 


V| o id 


7| D name 


Kl 4-145 


选择 对 应 上 下 文 


3) 接着 选择 不 同 字 段 在 表格 列 中 的 界面 元 素 类 型 ， 
的 方式 进行 展现 ， 单 击 “Finish” 按 钮 ， 如 图 4-146 所 示 。 
4) 完成 表格 创建 后 ， 视 图 中 就 能 看 到 自动 生成 的 表格 样式 ， 如 图 4-147 所 示 。 


将 其 中 的 “dept” 字 段 用 下 拉 列 表 


id |name | age | dept | createDate 

i v @createDate 
v @createDate 
v @createDate 


Attribute Editor 
id (PerLst.id) 


name (PerLst.name) 


Bound Prop... 


TextView @id @name | @age 


TextView @id @name @age 


age ( (PerLst. tage) 


createDate createDate (Perlst.cre... TextView 


Al 4-146 


调整 元 素 类 型 和 位 置 


图 4-147 预览 效果 


NS 


5) 对 表格 做 进一步 的 布局 优化 ， 插 入 标题 ， 
时 设置 表格 宽度 与 列 宽度 ， 如 图 4-148 所 示 。 


并 将 表格 的 列 名 称 改 为 实际 表格 名 称 ， 


ABs BAR 

p| 人 员 编号 | 姓名 | eae | 部 站 创建 日 其 
@id @name @age v @createDate 
@id @name @age v @createDate 
@id @name @age vv @createDate 


图 4-148 调整 属性 后 的 效果 
6) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-149 所 示 。 
a Re se en ergs 


7) 先 初 始 化 几 条 数据 。 


在 视图 的 “wdDoInit” 方 法 中 添加 以 下 测试 代码 ; 


同 


IPerLstNode nodePerLst 


createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 


createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 
createAndAddPerLstElement. 


= wdContext. nodePerLst( ) ; 
java. sql. Date date = new java. sql. Date( System. currentTimeMillis( ) ) ; 
IPerLstElement createAndAddPerLstElement = nodePerLst. createAndAddPerLstElement( ) ; 


setId( "001" ) ; 
setName(" 李 1"); 
setAge(30) ; 
setDept( "01" ) ; 
setCreateDate( date) ; 


createAndAddPerLstElement = nodePerLst. createAndAddPerLstElement( ) ; 


setId( "002" ) ; 
setName("4= 2"); 
setAge(31) ; 
setDept( "02" ) ; 
setCreateDate( date) ; 


e 并 重新 编译 、 
意 ， 部 门 的 类 型 仍然 是 之 前 建立 的 “Dept” 简 单 类 型 ， 


运行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-150 所 示 。 


所 以 在 初始 化 赋值 之 后 ， 下 
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拉 列 表 框 显示 了 数据 字典 中 简单 类 型 对 应 的 描述 


图 4-150 运行 效果 


2. 设置 属性 和 事件 
(1) 表格 属性 
在 完成 表格 的 创建 之 后 


， 继 续 对 视图 元 素 进行 


属性 的 


1) 修改 部 门 列 属性 ， 将 编辑 框 的 只 读 设 置 为 “tue"， 如 pidm 
图 4-151 所 示 。 aceon 
2) 保存 所 有 修改 ， 并 重新 进行 编译 、 运 行 。 由 于 表格 绑 定 的 
“PerLst” 结 点 的 可 选集 合 为 “0 . , 1”， 因 此 默认 情况 下 表格 仅 持 ACIS! Ina 

单 选 ， 不 支持 多 选 ， 如 图 4-152 所 示 。 


图 4-152 单行 选择 运行 效果 
3) 如 果 将 表格 的 “Initialize Lead Selection” 设置 为 “false”， 则 运行 后 视图 中 的 表格 不 
会 有 默认 选中 行 ， 如 图 4-153 所 示 。 
由 Aime me se sn SPEE] 


图 4-153 不 可 选 运行 效果 
4) 当 “PerLst” 结 点 的 可 选 属性 为 “0 .. n” 或 “1 . . n” 了 时， 表格 支持 多 选 ， 如 图 4-154 
所 示 。 
— ts 2# sn wmm 
Mo ¥1 PES 2138.27 
Dw E n mas 2013-827 


Al 4-154 多 选 运行 效果 


5) 接着 将 表格 的 “selectionMode” 属 
云 行 新 程 


性 修改 为 “single”， 随 后 编译 并 运 
序 ， 如 图 4-155 所 示 。 
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selectionMode single 


图 4-155 修改 属性 


6) 此 时 虽然 上 下 文 结 点 “PerLst” 仍 然 支持 多 选 ， 但 由 于 表格 属性 的 设置 ， 表 格 还 是 
只 支持 单 选 ， 如 图 4-156 所 示 。 


Ad SFE 

> Anes se |en iess E] 
[C] o + w Ass 
|_| ove #2 n mas 


7) 设置 表格 为 只 读 ， 将 “rowSelectable” 修改 为 “false”， 如 图 4-157 所 示 。 


readOnly true 


rowSelectable false 


图 4-157 修改 属性 


8) 重新 编译 并 运行 之 后 ， 表 格 行 项 目 将 无 法 被 选中 ， 如 图 4-158 所 示 。 


人 员 信 息 列表 

h Ant ms 2# sn 
= 30 Ase 
3 n mes 


am 
2013-8.27 
2013-827 


oo 
w 


图 4-158 ”运行 效果 


(2) 表格 事件 


下 面 通过 实例 来 了 解 表格 中 的 各 个 事件 定义 和 开发 。 
1) 创建 表格 默认 事件 “ColSelect”， 如 图 4-159 所 示 。 


4 Events 


onColSelect ColSelect 


图 4-159 ”修改 事件 属性 


2) 在 创建 该 自 定义 动作 时 ， 添 加 两 个 参数 “col” 和 “ele”， 用 于 处 理 选 中 行 的 序号 以 
及 表格 的 行 项 目 元 素 ， 如 图 4-160 所 示 。 


Details | Parameters | 


Name Type 


col string 


ele 


com.sap.tc.webdynpro.progmodel.api..WDNodeElement 


图 4-160 添加 参数 


3) 两 个 参数 分 别 需要 与 表格 元 素 进 行 参数 映射 ， 这 样 在 触发 相应 事件 时 才 会 自动 接收 
表格 元 素 传 递 的 标准 参数 。 在 “Outline” 中 右 击 “Table”， 并 选择 “Parameter Mapping” , 
如 图 4-161 所 示 。 


4) 在 弹出 的 对 话 框 中 将 表格 元 素 的 参数 与 动作 参数 进行 映射 ， 如 图 4-162 所 示 。 
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Create Binding 


Migrate Columns 


Parameter Mapping 4 一 4 Table 0 a Actions 

Translatable Texts 4 | \colselect 
col 

Apply Template 


4-161 ”进行 参数 映射 的 菜单 选择 图 4-162 ”进行 参数 映射 


5) 设置 表格 列 的 “colSelectionState” 为 “notSelected”， 如 图 4-163 所 示 。 
6) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-164 所 示 。 


Anaga 


o Ages | as 2% 50 
| eon * » ABE 
icolSelectionState notSelected Ele #2 31 mas 


K 4-163 ”修改 属性 Kl 4-164 运行 效果 
7) 选择 任意 的 人 员 编 号 行 后 ， 打 印 出 对 应 的 消息 , 证 明 已 获取 到 表格 列 的 标识 ， 如 
图 4-165 所 示 。 
8) 接着 创建 “onLeadSelect” 的 动作 并 用 同样 的 方法 添加 参数 ， 如 图 4-166 所 示 。 


z 所 在 列 ，id 行 项 目 : null onLeadSelect LeadSelect 
图 4-165 选择 后 的 效果 4-166 ”修改 属性 


9) 在 创建 该 自 定义 动作 时 ， 添 加 两 个 参数 “col” 和 “ele”， 用 于 处 理 选 中 行 的 序号 以 
及 表格 的 行 项 目 元 素 ， 如 图 4-167 所 示 。 


Details | Parameters 


com.sap.tc.webdynpro.progmodel.apiIWDNodeElement 


图 4-167 添加 参数 


10) 右 击 表格 ,使 用 同样 的 方式 进行 参数 映射 ， 如 图 4-168 所 示 。 
11) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-169 所 示 。 
|—a lleadseled| 


col 


人 只 信 息 列 农 
newRowElement | ARGS ae “8 | =n 
| £0. 
oldRowElement | mi #1 30 AF 
|] ove bad n Pes 


row 


nodeElement 


图 4-168 ”进行 参数 映射 图 4-169 运行 效果 


12) 当选 中 任意 一 行 时 ， 打 印 出 对 应 的 行 项 目 信 息 ， 如 图 4-170 所 示 。 
13) 接着 创建 “onSelect” 动 作 ， 如 图 4-171 所 示 。 


onLeadSelect 
行 项 目 : NodeElement(Dynp04_01Comp/Dynp04_01Comp_05View.PerLst.1) onSelect Select 
图 4-170 选择 后 的 效果 4-171 修改 事件 属性 
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ÌE: “onSelect” 与 “onLeadSelect” 动作 是 不 能 同时 定义 的 ， 因 为 前 者 包含 了 后 者 的 功 
能 ， 所 以 去 掉 了 之 前 设置 的 onLeadSelection 。 
14) 添加 自 定义 动作 中 的 参数 ， 如 图 4-172 所 示 。 


com.sap.tc.webdynpro.progmodel.apiIWDNodeElement 


图 4-172 ”添加 参数 


15) 右 击 表格 ,使 用 同样 的 方式 进行 参数 映射 ， 如 图 4-173 所 示 。 
16) 保存 所 有 修改 ， 并 重新 编译 、 。 即 可 进行 相关 测试 ， 如 图 4-174 所 示 。 


4 a [Select ETETTTI 
- D| Atat AS =e an 
newLeadSelection ot a 20 AB 
oldLeadSelection oldLead = i a1 Aas 
nodeElement | 


图 4-173 ”进行 参数 映射 图 4-174 运行 效果 


17) 选中 任意 行 后 ， 打 印 出 对 应 的 消息 ， 如 图 4-175 所 示 。 


(Biz: CMHF.Dynp04_01Comp_05View.PerLst.0 新 选项 : CMHF.Dynp04_01Comp_05View.PerLst.1 


图 4-175 选择 后 的 效果 


3. 过 滤 与 排序 功能 
表格 提供 了 标准 的 过 滤 与 排序 类 ， 对 于 自 定义 表格 可 以 通过 简单 封装 实现 过 滤 与 排序 。 
表格 过 滤 类 参考 代码 如 下 : 


public final class TableFilter | 
public TableFilter(TWDTable table ,[WDAction filterAction , 
IWDNode sourceNode, Hashtable hashicons ) | 
init( table, filterAction , sourceNode , hashicons) ; 
| 
private void init( IWDTable table,IWDAction filterAction , 
IWDNode sourceNode Hashtable hashicons ) } 
this. table = table; 
if (sourceNode == null ) 
throw new IllegalArgumentException("SourceNodemust be given" ) ; 
if (filterAction == null) 
throw new IllegalArgumentException(" Filter action must be given" ) ; 
if (table == null) 
throw new IllegalArgumentException( "Table must be given" ) ; 
if (table. bindingOfDataSource( ) == null) 
throw new IllegalArgumentException(" Data source of table with id " 
+ table. getld( ) +" must be bound" ) ; 
this. sourceNode = sourceNode ; 
if (hashicons ! = null) { 
this. hashIcon = new Hashtable( ) ; 
this. hashIcon = hashicons; 
| 


String dataSourcePrefix = table. bindingOfDataSource( ) + "."; 
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//works on columns 
setFiltersForColumns( dataSourcePrefix , table. iterateColumns( ) , 
sourceNode) ; 
setFiltersForColumns( dataSourcePrefix , table. iterateGroupedColumns( ) , 
sourceNode) ; 
table. setOnFilter(filterAction ) ; 
filterAction. setEnabled( true) ; 
this. sourceNode = sourceNode ; 
| 
private void setFiltersForColumns( String dataSourcePrefix , 
Iterator columnIterator , [IWDNode sourceNode ) | 
attributeSource = new Hashtable( ) ; 
for (Iterator iter = sourceNode. getNodeInfo( ) . iterateAttributes() ; iter 
. hasNext() ;) | 
IWDaAttributeInfo attribInfo = (IWDAttributeInfo) iter. next( ) ; 
String attribName = attribInfo. getName( ) ; 
attributeSource. put( attribName, attribInfo. getSimpleType( ) 
. getBuiltInType( ) ) ; 
| 
int index =0; 
for (Iterator it = columnlterator; it. hasNext() ; ++ index) | 
IWDAbstractTableColumn abstractColumn = (IWDAbstractTableColumn ) it 
. next( ) ; 
if (abstractColumn instanceof IWDTableColumn ) | 
IWDTableColumn column = (IWDTableColumn) abstractColumn ; 
String columnld = column. getld( ) ; 
Comparator comparator = null; 
NodeElementByAttributeComparator elementComparator = null ; 
String bindingOfPrimaryProperty = 
bindingOfPrimaryProperty ( column 
. getTableCellEditor( ) ) ; 
String attributeName = null; 
if (bindingOfPrimaryProperty == null 
|| ! bindingOfPrimary Property 
. starts With( dataSourcePrefix ) ) | 
if (hashIcon == null) | 
continue ; 
| else} 
if (! hashIcon. containsKey(columnld) ) į 
continue ; 
| else | 
attributeName = hashIcon. get( columnld) . toString() ; 


} 
| 
} else | 
attributeName = bindingOfPrimaryProperty 
. substring ( dataSourcePrefix. length( ) ) ; 
if (hashIcon. containsKey ( columnld ) ) 
attributeName = hashIcon. get( columnld) . toString( ) ; 
} 
String attributelnfo = null; 
if (attributeSource. containsKey ( attributeName ) ) 
attributeInfo = ( String) 
attributeSource. get ( attributeName ) ; 
elementComparator = new NodeElementByAttributeComparator( 
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attributeInfo , column , comparator) ; 
filterForColumn. put( attributeName , elementComparator ) ; 
| else if (abstractColumn instanceof IWDTableColumnGroup ) | 
IWDTableColumnGroup columnGroup = (1WDTableColumnGroup ) 
abstractColumn ; 
setFiltersForColumns( dataSourcePrefix , columnGroup 
. iterateColumns( ) , sourceNode) ; 


| 
| 
public void filter( TWDNode allDataNode ,I[WDNode targetNode) | 
if (allDataNode ! = null) | 
this. sourceNode = allDataNode; 
| 
HashMap FilterValuesByAttribute = prepareFilterValuesByAttribute( ) ; 
ArrayList ar = new ArrayList() ; 
for (int i=0; i < sourceNode. size(); i++) | 
IWDNodeElement el = sourceNode. getElementAt(i) ; 
boolean addelement = true; 
for (Enumeration e = this. attributeSource. keys( ) ; e 
. hasMoreElements( ) ; ) | 
String attributeName = e. nextElement( ). toString() ; 
Object ol = el. getAttributeValue( attributeName) ; 
if ( FilterValuesByAttribute. containsKey ( attributeName ) 
&&filterForColumn. containsKey ( attributeName) ) | 
NodeElementBy AttributeComparator elementComparator = ( NodeElementB- 
yAttributeComparator ) filterForColumn 
. get(attributeName ) ; 
HashMap valuehash = new HashMap( ) ; 
valuehash = (HashMap) FilterValuesByAttribute 
. get( attributeName) ; 
String attributetype = elementComparator. attributelnfo ; 
Comparator comparator = elementComparator. comparator ; 
if (valuehash. size( ) ==0) | 
elementComparator. column. setIsFiltered (false) ; 
| else} 
elementComparator. column. setIsFiltered (true) ; 
| 
addelement = this. evaluateFilteredAttributeValue( valuehash , 
attributetype , comparator ,ol ) ; 
if (! addelement) 
break ; 
| 
if (! addelement ) 
break ; 
| 
if (! addelement) 
continue ; 
IWDNodeElement targetElement = targetNode. createElement( ) ; 
WDCopyService. copyCorresponding ( el, targetElement) ; 
ar. add( targetElement) ; 
| 
targetNode. bind( ar) ; 


} 
public void deleteAllDataNodeElement( IWDNode sourceNode , 
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IWDNode targetNode , String attributeRowld, ArrayList idsToDelete ) | 
for (int j =sourceNode. size() -1; j > =0; --j) | 
IWDNodeElement els = sourceNode. getElementAt( j ) ; 
String elsid = els. getAttributeAsText( attributeRowld) ; 
if (! idsToDelete. contains (elsid) ) 
continue ; 
sourceNode. removeElement( els) ; 
| 
for (int i =targetNode. size() -1; i > =0; --1) | 
IWDNodeElement elt = targetNode. getElementAt(i) ; 
String eltid = elt. getAttributeAsText( attributeRowld) ; 
if (! idsToDelete. contains(eltid) ) 
continue ; 
targetNode. removeElement( elt) ; 


J * 
* Update all data node if the table node has been updated if a row has been 
* added in the table node, the all data node can also be updated by using 
* the using the flag addRowOnFly 
*/ 
public void updateAllDataNodeElement( IWDNode sourceNode, 
IWDNode targetNode , String attributeRowld, boolean addRowOnFly ) | 
HashMap hashs = new HashMap( ); 
HashMap hasht = new HashMap( ) ; 
HashMap hashup = new HashMap( ) ; 
IWDNodeElement elt; 
IWDNodeElement els; 
for (int j =sourceNode. size() -1; j > =0; --j) j 
els = sourceNode. getElementAt(j) ; 
String elsid = els. getAttributeAsText( attributeRowld) ; 
hashs. put(elsid, els) ; 
} 
for (int i=0; i < targetNode. size( ); i++ ) | 
elt = targetNode. getElementAt(i) ; 
String rowid = elt. getAttributeAsText ( attributeRowld ) ; 
boolean isInSource = hashs. containsKey ( rowid ) ; 
if (isInSource && | elt. isChangedByClient( ) ) 
continue ; 
if (! isInSource) | 
els = sourceNode. createElement( ) ; 
WDCopyService. copyCorresponding( elt, els) ; 
sourceNode. addElement( els) ; 
| else} 
els = (IWDNodeElement) hashs. get(rowid) ; 
WDCopyService. copyCorresponding( elt, els) ; 


| 
J * 
* find if an column has a valid filter and if so parse the filter and put 
* in a hash table 
*/ 
private HashMap prepareFilterValuesByAttribute( ) | 
HashMap hashmap = new HashMap( ) ; 


194 


for (Enumeration e = this. attributeSource. keys( ) ; e. hasMoreElements( ) ; ) | 
String attributeName = e. nexthlement( ). toString( ) ; 
if (filterForColumn. containsKey ( attributeName) ) | 
NodeElementByAttributeComparator elementComparator = ( NodeElementBy At- 
tributeComparator) filterForColumn 
. get(attributeName) ; 
IWDTableColumn column = elementComparator. column; 
column. setIsFiltered (false) ; 
String filtervalue = column. getFilterValue( ) ; 
if (filtervalue == null || filtervalue. trim( ). length( ) ==0) | 
continue ; 
} 
String attributetype = elementComparator. attributelnfo ; 
HashMap valuehash = new HashMap( ) ; 
valuehash = this. detectFilterSign (filtervalue ) ; 
hashmap. put( attributeName , valuehash) ; 
| 
} 
return hashmap ; 
} 
/ * generate a filter value into the right object * / 
private Object generateObject( String filtervalue , String attributetype , 
String sign) | 
Object 02 = filtervalue ; 
ty | 
if (filtervalue == null) | 
return 02; 
} 
if (attributetype. equalsIgnoreCase( " decimal" ) ) | 
02 = new BigDecimal ( filtervalue ) ; 
| 
if (attributetype. equalsIgnoreCase(" double" ) ) | 
02 = new Double( ( filtervalue) ) ; 
} 
if (attributetype. equalsIgnoreCase(" long" ) ) | 
02 = new Long(filtervalue) ; 
| 
if (attributetype. equalslgnoreCase( " float" ) ) | 
02 = new Float(filtervalue) ; 
| 
if (attributetype. equalsIgnoreCase(" short" ) ) | 
02 = new Short(filtervalue) ; 
} 
if (attributetype. equalsIgnoreCase( " integer" ) ) | 
02 = new Integer‘ filtervalue ) ; 
| 
if (attributetype. equalslgnoreCase( " long" ) ) | 
02 = new Long( filtervalue ) ; 
} 
if (attributetype. equalsIgnoreCase( " date" ) ) | 
try | 
java. util. Date dtTmp = new java. util. Date (filtervalue ) ; 
SimpleDateFormat template = new SimpleDateF ormat ( 
"yyyy -MM - dd" ) ; 
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format(dtTmp) ) ; 


| 


| 


| 


| 


02 = String. valueOf(template. format( dtTmp ) ) ; //Date. valueOf(template. 


| catch (Exception ex) | 
o2 = filtervalue; 


| 


if (attributetype. equalsIgnoreCase( " time" ) ) | 


try | 
SimpleDateFormat timeformater = new SimpleDateFormat( 
"hh:mm:ss" , WDResourceHandler 
. getCurrentSessionLocale( ) ) ; 


02 = timeformater. parse ( filtervalue ) ; 
| catch (ParseException ex) | 
02 = filtervalue; 


| 


| 
if (attributetype. equalsIgnoreCase(" boolean" ) ) | 
if (sign. equalsIgnoreCase( NE) ) | 
02 = new Boolean(true) ; 


} else | 
02 = new Boolean(true) ; 


| 


| 


return 02; 
catch (Exception ex) | 
return filtervalue ; 


/ * compare object according the filter * / 
private boolean evaluateFilteredAttributeValue( HashMap filter, 


String attributetype , Comparator comparator ,Object ol ) | 


boolean accept = true; 
wy | 
if (filter == null || filter. size( ) ==0) 


return accept; 

if (attributetype == null || attributetype. trim( ). length( ) ==0) 
return accept; 

Object 02 = filter. get( "valuel" ) ; 

if (filter. get("sign" ) == null) | 


if (o2 1 =null) } 
String valuel = filter. get( "valuel" ) .toString( ) ; 


02 = generateObject( valuel , attributetype, null) ; 


| 


int compared = comparator. compare( o1 ,02 ) ; 
if (! attributetype. equalslgnoreCase( " string" ) ) | 


if (compared ==0) | 
return accept; 


| else | 
return (! accept) ; 


| 
} else | 
if (compared > =0) | 


return accept; 


| else | 
return (! accept) ; 
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| 
| 
String sign = filter. get( " sign" ). toString( ) ; 
String place = filter. get( " place" ) .toString( ) ; 
if (sign. equalsIgnoreCase( EQ) && place. equalsIgnoreCase( "S" ) ) | 
if (o2 ! =null) f 
String valuel = filter. get( " valuel" ). toString() ; 
02 = generateObject( valuel , attributetype, sign) ; 
| else | 
if (attributetype. equalslgnoreCase(" boolean" ) ) | 
02 = generateObject( " " , attributetype , sign ) ; 


} 
J 


if (attributetype. equalsIgnoreCase( "string" ) && ol ! =null 
&&ol. toString(). trim(). length( ) ==0) | 
02 = generateObject( " " , attributetype , sign ) ; 
| 
| 
int compared = comparator. compare(ol ,o2 ) ; 
if (! attributetype. equalslgnoreCase(" string" ) ) | 
if (compared ==0) | 
return accept; 
| else} 
return (! accept) ; 
| 
} else | 
if (compared > =0) | 
return accept; 
| else | 
return (! accept) ; 
| 
| 
| 
if (sign. equalsIgnoreCase(NE) && place. equalsIgnoreCase("S" ) ) | 
if (02 1 =null) | 
String valuel = filter. get(" valuel" ) . toString() ; 
02 = generateObject( valuel , attributetype, sign) ; 
} else} 
if (attributetype. equalslgnoreCase(" boolean" ) ) | 
02 = generateObject( " " , attributetype, sign) ; 
| 
if (attributetype. equalslgnoreCase( " string" ) && ol | = null 
&&ol. toString( ). trim( ) . length( ) ==0) | 


"nn 


02 = generateObject("" , attributetype, sign) ; 
| 
| 
int compared = comparator. compare( ol ,o2 ) ; 
if (! attributetype. equalsIgnoreCase( " string" ) ) | 
if (compared ==0)| 
return | accept; 
| else} 
return (accept) ; 
| 
| else | 


if (compared > =0) | 
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return | accept; 
| else} 
return (accept) ; 
} 
} 
| 
if (sign. equalsIgnoreCase( R) && place. equalsIgnoreCase( " S" ))| 
if (02 1 =null)| 
String valuel = filter. get( "valuel" ). toString( ) ; 
02 = generateObject( valuel , attributetype, sign) ; 
| 
int compared = comparator. compare( ol ,02 ) ; 
if (compared > 0) | 
return ! accept; 
| else} 
return (accept) ; 
} 
| 
if (sign. equalsIgnoreCase(R) && place. equalsIgnoreCase( "E" ) ) | 
if (02 ! =null) | 
String valuel = filter. get(" valuel" ) .toString( ) ; 
02 = generateObject( valuel , attributetype, sign) ; 
| 
int compared = comparator. compare(ol ,o2 ) ; 
if (compared > =0) | 
return accept; 
| else} 
return (! accept) ; 
| 
} 
Object 03 = filter. get(" value2" ) . toString( ) ; 
if (sign. equalsIgnoreCase(R) && place. equalslgnoreCase("M" ) ) | 
boolean accept! = true; 
boolean accept2 = true; 
if (02 ! =null) f 
String valuel = filter. get( " valuel" ). toString() ; 
02 = generateObject( valuel , attributetype, sign) ; 
| 
if (03 1 =null) | 
String valuel = filter. get( "value2" ) . toString() ; 
03 = generateObject( valuel , attributetype, sign) ; 
| 
int compared = comparator. compare(ol ,02 ) ; 
if (compared > =0) | 
acceptl = accept; 
} else | 
acceptl =! accept; 
| 
int compared2 = comparator. compare(ol ,03 ) ; 
if (compared2 > 0) } 
accept2 =! accept; 
| else} 
accept2 = accept; 
} 
if (acceptl && accept2 ) | 
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return accept; 
} else} 
return ! accept; 
} 
} 
return accept; 
| catch (Exception ex) | 
return accept; 
| 
| 
/ * parse the filter */ 
private HashMap detectFilterSign (String value) | 
HashMap ar = new HashMap() ; 
String vall = null; 
String val2 = null; 
String sign = null; 
String place = null; 
if (null == value) | 
ar. put("valuel" , value) ; 
ar. put( "sign" ,null) ; 
return ar; 
} 
if (! value. startsWith(EQ) & ! value. startsWith( NE) 
&value. indexOf(R) < 0) }{ 
ar. put( "valuel" , value. trim( ) ) ; 
ar. put( "sign" ,null) ; 
return ar; 
} 
if (value. startsWith( EQ) ) | 
if (value. trim( ). length() > 1) | 
vall = value. substring(1) ; 
| else} 
vall = 


nA, 
9 


vall = null; 
} 
sign = EQ; 
place = "S"; 
ar. put( "valuel" ,vall ) ; 
ar. put( "sign" ,EQ) ; 
ar. put( " place" , place) ; 
return ar; 
} 
if (value. startsWith( NE) ) | 
if (value. trim().length() > 1) | 
vall = value. substring(1) ; 
| else} 
valli =" 
vall = null; 
} 
sign = NE; 
place = "S"; 
ar. put( "valuel" , vall ) ; 
ar. put( "sign" ,NE) ; 
ar. put( " place" , place) ; 
return ar; 
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} 
if (value. startsWith(R) ) | 
if (value. trim().length() > 1) | 
vall = value. substring(1) ; 
} else} 
wall =" 2 
vall = null; 
| 
sign 三 肛 ; 
place = "S"; 
ar. put( "valuel" , vall ) ; 
ar. put( "sign" ,R) ; 
ar. put( " place" , place) ; 
return ar; 
} 
if (value. endsWith(R) ) | 
if (value. trim( ). length() > 1) | 
vall = value. substring(0, value. length( ) -1) ; 
| else} 
valle 
vall = null; 
} 
sign =R; 
place = "E"; 
ar. put( " valuel " ,vall ) ; 
ar. put( "sign" ,R); 
ar. put( " place" , place) ; 
return ar; 
} 
if (value. indexOf(R) > 0) | 
sign =R; 
place = "M" ; 
vall = value. substring(0, value. indexOf(R) ) ; 
val2 = value. substring( value. indexOf( R) +1); 
ar. put( " valuel" , vall ) ; 
ar. put( "value2" , val2) ; 
ar. put( "sign" ,R) ; 
ar. put( " place" , place) ; 
return ar; 
} 
if (ar. size( ) ==0) 
ar. put( "valuel" , value) ; 
return ar; 
} 
private static final String bindingOfPrimary Property ( 
IWDTableCellEditor editor) | 
return editor instanceof [WDViewElement ? 
bindingOfPrimaryProperty ( (IWDViewElement) editor) 
: null; 
} 
private static final String bindingOfPrimaryProperty( TWD ViewElement element) | 
if (element instanceof IWDAbstractDropDownByIndex ) 
return ((IWDAbstractDropDownByIndex ) element). bindingOfTexts( ) ; 
if (element instanceof IWDAbstractDropDownByKey ) 
return ( (IWDAbstractDropDownByKey ) 
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element). bindingOfSelectedKey( ) ; 


| 


if (element instanceof IWDAbstractInputField ) 

return ((IWDAbstractInputField) element) . bindingOfValue( ) ; 
if (element instanceof [WDCaption ) 

return ((IWDCaption) element). bindingOfText( ) ; 
if (element instanceof IWDCheckBox ) 

return ((IWDCheckBox) element). bindingOfChecked( ) ; 
if (element instanceof IWDLink ) 

return ((IWDLink) element). bindingOfText( ) ; 
if (element instanceof [WDProgressIndicator ) 

return ((IWDProgressIndicator) element). bindingOfPercentValue( ) ; 
if (element instanceof IWDRadioButton ) 

return ((IWDRadioButton) element) . bindingOfSelectedKey( ) ; 
if (element instanceof [WDTextEdit ) 

return ((IWDTextEdit) element). bindingOfValue( ) ; 
if (element instanceof IWDTextView ) 

return ((IWDTextView) element). bindingOfText() ; 


return null; 


private static final Comparator DEFAULT = new Comparator( ) | 


E 


public int compare( Object o1 ,Object 02) | 
if (ol ==null && 02 == null) | 
return 0; 
| 
if (ol ==null) | 
return — 1; 
| 
if (02 ==null) | 
return — 1; 
} 
if (ol instanceof Boolean && 02 instanceof Boolean) | 
return ol. toString( ). compareTo( 02. toString() ) ; 
} 
if (ol instanceof Date && o2 instanceof Date) | 
return ( (java. util. Date) ol). compareTo( (java. util. Date) 02) ; 
} 
if (ol instanceof String && o2 instanceof String) | 
Collator collate = Collator. getInstance ( WDResourceHandler 
. getCurrentSessionLocale( ) ) ; 
return ol. toString( ). toUpperCase( 
WDResourceHandler. getCurrentSessionLocale( ) ). indexOf( 
02. toString( ). toUpperCase ( 
WDResourceHandler. getCurrentSessionLocale() ) ) ; 
| 
return ( (Comparable) 01). compareTo( (Comparable) o2 ) ; 


| 


private Hashtable filterForColumn = new Hashtable( ) ; 
private [WDTable table = null; 
private Hashtable attributeSource = null; 


private Hashtable sourceNodeHash = null; 


private Hashtable hashlcon = null; 


private IWDNode sourceNode = null; 
private IWDNode targetNode = null; 
See BO = oo. 
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String NE ="#"; 
String R=" ~"; 
public final class NodeElementByAttributeComparator | 
public NodeElementByAttributeComparator( String attributelnfo , 
IWDTableColumn column , Comparator comparator) | 
this ( attributeInfo , column , comparator , false ,new ArrayList( ) ) ; 
| 
private NodeElementByAttributeComparator( String attributeInfo , 
IWDTableColumn column, Comparator comparator , 
boolean compareAsText , Collection subNodes) | 
if (attributeInfo == null) 
throw new IllegalArgumentException( 
" attributeInfo must not be null" ) ; 
if (column == null) 
throw new IllegalArgumentException('" Columnmust not be null" ) ; 
if (comparator == null) 
comparator = DEFAULT; 
this. attributeInfo = attributeInfo; 
this. column = column; 
this. comparator = comparator ; 
this. compareAsText = compareAsText; 
this. subNodes = subNodes; 
| 
private final Comparator comparator ; 
private final boolean compareAsText ; 
private IWDTableColumn column; 
private Collection subNodes ; 
private String attributelnfo; 


| 


进入 文件 导航 器 “Navigator” 新 建 一 个 文件 夹 “util”， 并 将 之 前 创建 的 两 个 工具 类 复制 
到 对 应 目录 中 ， 如 图 4-176 所 示 。 

(1) 过 滤 功 能 

1) 在 视图 上 下 文中 定义 过 滤 变 量 ， 如 图 4-177 所 示 。 


4 S mydynp04 


4 wd 
> & app 
> {> comp 
> $ ddic © Manually 
4 (> util Name: Tablefilter 


J) TableFilter.java 
四 j 
四 TableSorterjava 


Type: |com.sap.demo.mydynp04.wd.util. TableFilter 


7 


K 4-176 ”新建 “util” 文 件 夹 图 4-177 在 上 下 文中 添加 特性 


2) 定义 过 滤 用 结 点 ， 过 滤 结 点 集合 属性 为 “1 .. 1”， 并 且 结 构 需 与 源 数 据 结 点 保持 一 
致 ， 如 图 4-178 所 示 。 
3) 定义 源 结 点 ， 源 结 点 集合 属性 为 “0 .. n”, 源 结 点 与 过 滤 后 结 点 (实际 业务 数据 


aa, 


结 点 ) 结构 一 致 ， 如 图 4-179 所 示 。 
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4 [C Perlst_Filter| a C Perlst All] 
B age B age 
Ð createDate B createDate 
B dept B dept 
B id D id 
B name B name 


图 4-178 特性 清单 1 图 4-179 特性 清单 2 
4) 创建 过 滤 功 能 对 应 的 事件 ， 如 图 4-180 所 示 。 
| 


Z| 4-180 ”修改 事件 属性 


5) 进入 Java 编辑 器 ， 在 方法 中 添加 以 下 过 滤 人 代码 : 


wdContext. currentContextElement( ). getTableFilter( ). filter( 
wdContext. nodePerLst_All( ) , wdContext. nodePerLst( ) ) ; 
wdDoModifyView 方法 中 添加 初始 化 方法 
if(firstTime) | 

// 获 取 UI Table Element 

table = (IWDTable) view. getElement( "Table_ 0" ) ; 

// 初 始 化 TableFilter 类 

wdContext. currentContextElement( ). setTableFilter( 

new TableFilter( table, wdThis. wdGetFilterAction( ) ， 
wdContext. nodePerLst_All(.) , new Hashtable( ) ) ) ; 

// 初 始 化 过 滤 , 默 认 情 况 下 过 滤 条 件 为 空 , Table 显示 源 数据 
wdThis. onActionFilter( null) ; 

| 


6) 选中 需要 设置 的 过 滤 列 ， 如 图 4-181 所 示 。 


4 Properties[TableColumn] 
id id 


图 4-181 打开 对 应 列 的 属性 


7) filterValue 绑 定 过 滤 结 点 对 应 属性 ， 如 图 4-182 所 示 。 


filterValue B PerLst_Filter.id 


Al4-182 ”修改 属性 


8) 设计 页 面 显示 过 滤 输 入 框 ， 如 图 4-183 所 示 。 
9) 用 同样 的 方式 设置 其 他 列 ， 如 图 4-184 所 示 。 
人 员 信息 列表 
| ARS | 姓名 | |an 创建 日 其 
FF @id @name @dept 
H @id @name @age 7| @createDate 
@id @name @age v @createDate 
@id @name @age v @createDate 


图 4-183 预览 效果 图 4-184 设置 后 预览 效果 
有 的 应 用 可 能 在 设置 filterValue 后 ,输入 框 仍然 只 读 ， 此 时 应 该 注意 查看 过 滤 结 点 Ini- 


tialize Lead Selection 属性 。 前 面 讲 过 ， 对 于 集合 属性 为 1: .1 的 结 点 ， 可 以 当 作 单个 实体 来 
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Æ fF, Initialize Lead Selection 为 false， 那 么 结 点 currentElement W null, #7 AKER, Ab, 
通过 图 4-184 可 以 看 到 ， 只 对 类 型 为 string 的 列 设置 了 filterValue， 由 于 提供 的 标准 过 滤 类 
目前 只 考虑 了 字符 的 情况 ， 因 此 对 于 数字 、 有 日 期 等 类 型 可 以 考虑 通过 类 型 转换 的 方式 来 


实现 。 
修改 初始 化 数据 代码 。 当 Table 实现 了 过 滤 之 后 ，Table 绑 定 的 结 点 变 为 目的 结 点 ， 即 
Table 显示 的 数据 一 直 是 执行 过 滤 Action 后 的 数据 。 因 此 初始 化 数据 时 就 变 成 了 对 源 结 点 的 
初始 化 。 
wdDoInit( ) 方 法 中 修改 为 以 下 代码 ， 
IPerLst_AllNode nodePerLst = wdContext. nodePerLst_All( ); // 获 取 源 结 点 对 象 索 引 
/初始 化 两 条 数据 


java. sql. Date date = new java. sql. Date( System. currentTimeMillis( ) ) ; 
IPerLst_AllElement createAndAddPerLstElement = nodePerLst 

. createAndAddPerLst_AllElement( ) ; 

createAndAddPerLstElement. setId( "001" ) ; 
createAndAddPerLstElement. setName(" 4 1" ) ; 
createAndAddPerLstElement. setAge(30) ; 

createAndAddPerLstElement. setDept("01" ) ; 
createAndAddPerLstElement. setCreateDate ( date ) ; 
createAndAddPerLstElement = nodePerLst. createAndAddPerLst_AllElement( ) ; 
createAndAddPerLstElement. setId( "002" ) ; 
createAndAddPerLstElement. setName("4= 2" ) ; 
createAndAddPerLstElement. setAge(31) ; 

createAndAddPerLstElement. setDept("02" ) ; 
createAndAddPerLstElement. setCreateDate ( date ) ; 


总 结 : 过 滤 的 原理 是 通过 用 户 输入 的 过 滤 条 件 从 源 数据 中 筛选 出 符合 条 件 的 数据 ， 
Table 绑 定 的 数据 结 点 为 目的 结 点 。 初 始 化 时 ， 直 接 往 源 结 点 中 初始 化 数据 ， 并 且 此 时 没有 
任何 过 滤 条 件 ， 仍 然 执 行 过 滤 Action ， 程 序 默 认 将 源 结 点 数据 全 部 复制 到 目的 结 点 ， 当 用 户 
执行 过 滤 Action 时 ， 标 准 过 滤 类 会 通过 过 滤 结 点 获取 过 滤 条 件 ， 并 从 源 结 点 中 做 过 滤 ， 过 
滤 后 数据 赋值 到 目的 结 点 ， 即 表格 显示 的 数据 。 这 就 是 整个 过 滤 的 过 程 ， 所 以 在 Table 过 滤 
的 简单 封装 中 ， 也 可 以 围绕 这 个 流程 去 实现 。 

10) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-185 所 示 。 


EEC BE =e =I 
Wa 

001 = 30 Ate 
|__| ooz #2 3 Ras 


PETTEE] 
H FARRS nS =y an 
Boor 

cor #1 20 ABH 


图 4-186 ”运行 效果 2 


204 


(2) 排序 功能 
1) 排序 比 过 滤 简 单 ， 初 始 化 标准 排序 类 ， 并 创建 排序 动作 后 便 可 使 用 。 首 先 在 上 下 文 
中 定义 排序 特性 ， 如 图 4-187 所 示 。 


@ Manually 


Name: TableSorter 


Type: | com.sap.demo.mydynp04.wd.util.TableSorter z] | Browse... 


图 4-187 添加 上 下 文 特性 
2) 创建 排序 的 动作 ， 如 图 4-188 所 示 。 


onSort Sort 
E| 4-188 ”修改 事件 属性 


3) 在 方法 中 实现 逻辑 ， 代 码 如 下 : 


wdContext. currentContextElement( ). getTableSorter( ). sort( wdEvent, wdContext. nodePerLst( ) ) ; 
wdDoModifyView 中 添加 初始 化 TableSorter 类 方法 。 

if(firstTime ) | 

wdContext. currentContextElement( ). setTableSorter( new 

TableSorter( table, wdThis. wdGetSortAction( ) null) ) ; 

} 


4) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-189 所 示 。 


人 其 信息 列表 

H Axes #z Æ$ | = E 
%1 #1 30 AFR T wean 
002 #2 31 Mies z amasan 


图 4-189 运行 效果 


5) 单 击 列 头 即 可 进行 排序 ， 如 图 4-190 所 示 。 


ARMS 

p| Atat pa se 51 
| 001 mt w ABH 
002 #2 34 mas 


KI 4-190 ”排序 后 的 效果 


4.3.4 树 


其 实在 Web Dynpro 的 上 下 文 定义 中 一 直 使 用 的 就 是 一 个 树 状 结构 ， 而 SAP 为 了 将 整个 
上 下 文 结构 进行 可 视 化 的 展示 ， 定 义 了 Web Dynpro 中 的 树 。 开 发 人 员 在 进行 设计 开发 时 ， 
如 果 无 法 确定 树 的 层级 (深度 ) ， 则 可 以 在 上 下 文 定义 时 使 用 “循环 结 点 ”， 一般 循环 结 点 
使 用 的 就 是 它 父 结 点 的 对 象 ， 如 果 能 够 确定 树 的 层级 ， 则 无 须 使 用 循环 结 点 ， 使 用 一 般 类 型 
的 结 点 即 可 。 
它 包 含 以 下 一 系列 属性 。 
è contextMenuBehaviour; 设置 上 下 文 业 单行 为 ， 默认 有 “继承 ”“ 人 允许 ”和 “ 禁 上 ”3 
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种 类 型 。 
e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 
e dataSource: 树 所 绑 定 的 上 下 文 结 点 数据 源 。 
e defaultItemIconSource : 控制 显示 在 叶 结 点 的 图 标 路 径 。 
e defaultNodelconSource: 控制 显示 在 结 点 的 图 标 路 径 。 
e enabled: 控制 元 素 是 否 可 用 。 
e minHeight: 控制 树 元 素 的 最 小 高 度 。 
e iootText: 控制 根 结 点 的 文本 描述 。 
rootVisible: 控制 根 结 点 是 否 可 见 。 
e selectionChangeBehaviour: 设置 触发 事件 时 ， 是 否 自 动 切换 父 结 点 的 首选 项 (lead 
selection) ， 有 自动 或 手动 两 个 选项 。 
è titleVisible: 控制 树 的 标题 是 否 可 见 。 
e tooltip: 控制 提示 消息 的 显示 文本 。 
e visible; 控制 元 素 是 否 可 见 。 
e width; 控制 元 素 的 显示 宽度 。 
树 结 点 的 属性 如 下 。 
e dataSource: 绑 定 的 数据 源 。 
e hasChildren; 是 否 含 有 下 级 结 点 。 
© ignoreAction; 是 否 忽 上 略 选 择 触 发 的 Actions 
e text; Tree 结 点 的 描述 。 
开发 实例 : 
1) 首先 在 视图 上 下 文中 定义 树 的 数据 源 结 点 和 特性 ， 如 图 4-191 所 示 。 
(DD“TreeNode” 的 集合 属性 为 “0 . .an”， 是 否 初始 化 首选 项 “Initialize Lead Selection” 
为 “false”。 
© 特性 “id” 和 “name” 的 类 型 为 字符 串 型 ， 用 于 存放 代码 与 名 称 。 
© 特性 “hasChildren” 的 类 型 为 布尔 型 ， 控 制 是 否 含有 下 级 结 点 。 
O 特性 “ignoreAction” 的 类 型 为 布尔 型 ， 控 制 是 否 忽 略 选 择 的 Action 。 
© 特性 “isExpanded” 的 类 型 为 布尔 型 ， 控 制 是 否 能 够 展开 下 级 结 点 。 
2) 右 击 “TreeNode”， 添 加 一 个 循环 结 点 (Recursion Node) ， 输 入 循环 结 点 的 名 称 ， 如 
图 4-192 所 示 。 
器 TreeNode 


@ hasChildren @ Manually 
id 


Name: RecurTreeNode 


B 

B ignoreAction 

B isExpanded Repeated Node TreeNode 
B 


name 


KI 4-191 树 元 素 图 4-192 创建 循环 结 点 
对 应 的 上 下 文 结构 
3) 创建 完成 后 ， 保 存 所 有 修改 ， 如 图 4-193 所 示 。 
4) 右 击 “Outliine” 元 素 清单 中 的 “RootElement” 根 结 点 ,选择 插入 子 对 象 , 选择 
“Group”， 输 入 ID 名 称 ， 单 击 “OK” 按 钮 。 将 组 的 宽度 定义 为 “100%”， 将 “layout” 属性 修改 
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为 “GridLayout”， 将 “Header” 修 改 为 “组 织 体系 "。 在 组 中 添加 两 个 透明 容器 ， 将 “LayoutDa- 
ta” 中 的 “Width” 分 别 设置 为 “30%” 和 “70%”， 如 图 4-194 所 示 。 


4 Q TreeNode 
固 RecurTreeNode | 
hasChildren 
BD id 
B ignoreAction 
B 
B 


5-C7] Group 
T Group_Header [Header] 
TransparentContainer 


isExpanded 


name 


TransparentContainer1 


图 4-193 ”创建 后 的 效果 图 4-194 ”元 素 清单 

5) 右 击 “TransparentComtainer” 透 明 容 右 ， 选 择 插入 一 个 子 对 象 ， 选 择 “Tree”， 输 入 
ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-195 所 示 。 

6) Hit “Tree”, 3# “InsertNodeType” —> “TreeNodeType”, 插入 一 个 结 点 ， 如 
图 4-196 所 示 。 


fi TreeltemType 
-[_] TransparentContainer ld 1reeNodeType 
H Tree 


图 4-195 创建 后 的 效果 图 4-196 选择 树 结 点 类 型 
7) 完成 界面 元 素 定 义 后 ， 在 元 素 清单 中 可 以 看 到 新 的 界面 结构 ， 如 图 4-197 所 示 。 
8) 选中 “Tree”， 将 “Datasource” 数 据 源 属 性 与 上 下 文中 的 “TreeNode” 结 点 进行 绑 
定 ， 如 图 4-198 所 示 。 


5-[_] TransparentContainer 


i 日 -图 Tree Q’ TreeNode| 
i H TreeNodeType RecurTreeNode 


图 4-197 添加 结 点 后 的 效果 图 4-198 选择 对 应 的 上 下 文 进行 绑 定 


9) 修改 “rootText+” 属 性 为 “组 织 架 构 ”， 修改“width” 为 “200px”， 如 图 4-199 
所 示 。 


dataSource TreeNode 
defaultltemIconSource 
defaultNodeIconSource 


enabled true 
minHeight 

rootText 组 织 架构 
rootVisible true 
selectionChangeBehaviour auto* 
title 

titleVisible visible* 
tooltip a 

visible visible* 
width 200px 


图 4-199 ”修改 属性 

10) 接着 修改 树 的 结 点 “TreeNodeType”。 将 “dataSource” 属 性 与 上 下 文中 的 “Tree- 
Node” 进 行 绑 定 ， 其 他 属性 参考 图 4-200 进行 修改 。 由 于 使 用 的 是 循环 结 点 ， 因 此 视图 中 
树 元 素 的 数据 源 和 叶 结 点 的 数据 源 使 用 的 是 同一 个 上 下 文 对 象 。 


11) 完成 所 有 配置 后 ， 在 视图 中 能 看 到 界面 的 预览 图 ， 如 图 4-201 所 示 。 
12) 接着 在 上 下 文中 新 建 一 个 结 点 和 两 个 特性 ， 用 于 显示 明细 数据 信息 。 模 拟 选 中 单 
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条 项 目 时 明细 显示 ， 结 点 “Detail” 的 结合 属性 设置 为 “1 .. 1”， 如 图 4-202 所 示 。 


Pi 
v AREH 
v @name 
= @name 
«= @name 
dataSource C TreeNode = @name 
design standard* v @name 
expanded B TreeNode.isExpanded = @name 
hasChildren B TreeNode.hasChildren = @name 
iconSource = @name 
ignoreAction B TreeNode.ignoreAction v @name 
text B TreeNode.name = @name 
textDirection inherit* = @name 
tooltip = @name 


图 4-200” 树 元 素 的 属性 图 4-201 预览 效果 
13) 右 击 “TransparentContainerl ”并 选择 应 用 模板 ， 随 后 选择 表单 类 型 ， 并 使 用 
“Detail” 绪 点 进行 表单 的 自动 生成 ， 如 图 4-203 所 示 。 


[C Detail 4 (CQ Detail 
B id V] B id 
B name 7| D name 
图 4-202 ”添加 特性 后 的 效果 图 4-203 ”选择 对 应 的 上 下 文 


14) 两 个 特性 在 表单 中 的 显示 都 使 用 输入 框 元 素 进行 展现 ， 如 图 4-204 所 示 。 
15) 模板 运行 完毕 后 ， 自 动 生 成 表单 相关 元 素 ， 如 图 4-205 所 示 。 


Name Attribute Editor Bound Prop... 
id id (TreeNode.id) InputField value 
name name (TreeNode.nam... InputField value 
Sats: @id 
名 称 : @name 
图 4-204 ”修改 元 素 的 类 型 和 位 置 图 4-205 ”预览 效果 
16) 将 表单 与 之 前 的 树 元 素 一 同 放 入 组 “Group” 中 ， 如 图 4-206 所 示 。 


组 织 体系 


pj Sats: @id 
v 组 织 架构 名称 : @name 


v @name 


v @name 
v @name 
v @name 
v @name 
v @name 
v @name 
v @name 
v @name 
v @name 
v @name 


v @name 


Kl 4-206 运行 效果 
17) 在 视图 的 “wdDomit” 初 始 化 方法 中 添加 下 列 测 试 代码 : 
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// WRAL Tree 


ITreeNodeNode nodeTreeNode = wdContext. nodeTreeNode( ) ; 


ITreeNodeElement createAndAddTreeNodeElement = nodeTreeNode 


. ereateAndAddTreeNodeElement( ) ; 
createAndAddTreeNodeElement. setId( " OCO001" ) ; 
createAndAddTreeNodeElement. setName("SAPEYESO1" ) ; 
createAndAddTreeNodeElement. setHasChildren( true) ; 
createAndAddTreeNodeElement. setIgnoreAction( true) ; 
createAndAddTreeNodeElement = nodeTreeNode 

. ereateAndAddTreeNodeElement( ) ; 
createAndAddTreeNodeElement. setId( " OCO002" ) ; 
createAndAddTreeNodeElement. setName("SAPEYESO2" ) ; 
createAndAddTreeNodeElement. setHasChildren( true) ; 
createAndAddTreeNodeFlement. setIgnoreAction( true) ; 
createAndAddTreeNodeElement = nodeTreeNode 

. ereateAndAddTreeNodeElement( ) ; 
createAndAddTreeNodeElement. setId( " OC0003" ) ; 
createAndAddTreeNodeElement. setName ( " SAPEYES03" ) ; 
createAndAddTreeNodeElement. setHasChildren( true) ; 
createAndAddTreeNodeElement. setIgnoreAction( true) ; 


// 赋 值 代 码 
// 赋 值 名称 


// 赋 值 代码 
// 赋 值 名称 


// 赋 值 代码 
// 赋 值 名 称 


18) 


19) 添加 事件 处 理 器 中 的 方法 参数 ， 如 图 4-208 所 示 。 


定义 树 结 点 的 标准 事件 “onLoadChildren”， 定 义 新 动作 , 


4 Events 
onAction 


onDrop 


onLoadChildren LoadChildren 


图 4-207 修改 事件 属性 


Name ele 


Type | com.sap.demo.mydynp04.wd.comp.dynp04_0lcomp.wdp. ~ | Browse... 


| Array Type 


Dimension 


图 4-208 ”添加 参数 


20) 参数 类 型 选择 “TreeNodeElement” 生成 的 本 地 类 ， 如 图 4-209 所 示 。 


21) 复制 参数 至 参数 中 ， 如 图 4-210 所 示 。 


© Simple Type 
© Core Data Type 
© Java Native Type 


Java Native Type q eDynp04,01Comp_33View} reeNodeElement 


Browse... 


Fl 4-209 选择 对 应 类 型 


Details [Parameters] g 


BS 


4-210 添加 后 的 效果 


如 图 4-207 所 示 。 
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22) 定义 元 素 的 参数 映射 ， 如 图 4-211 所 示 。 将 TreeNodeType onLoadChildren 与 自 定义 
的 Action 参数 做 关联 。 


TreeNodeType 4 Actions 
lonLoadChildren} 一 一 —— 4 |LoadChildren 
path ee ort ele} 
图 4-211 进行 参数 映射 


23) 进入 Event Handler 实现 ， 通 过 循环 结 点 编写 加 载 下 级 结 点 逻辑 ; 


// 获 取 循 环 结 点 
ITreeNodeNode nodeRecurTreeNode = ele. nodeRecurTreeNode( ) ; 
String id = ele. getld() ; 
// 根 据 选 中 的 当前 结 点 判断 是 否 构造 下 级 树 
if(id! = null && id. contains("P" ) ) | 
// 选 择 的 结 点 类 型 为 人 员 时 不 再 填充 下 级 结 点 
ele. setHasChildren( false) ; 
ele. setIsExpanded ( false ) ; 
| else if(id! = null && id. contains(" OC" ) ) | 
// 选 择 的 结 点 类 型 为 公司 时 ,填充 下 级 部 门 结 点 
ITreeNodeElement createAndAddTreeNodeElement = nodeRecurTreeNode 
. create AndAddTreeNodeElement( ) ; 


. createAndAddTreeNodeElement( ) ; 


| 


createAndAddTreeNodeElement. setId("OD0001" ) ; // 赋 值 代码 
createAndAddTreeNodeElement setName(" 部 门 1" ) ; /赋值 名 称 
createAndAddTreeNodeElement. setHasChildren( true) ; 
createAndAddTreeNodeElement. setIgnore Action( true) ; 
createAndAddTreeNodeElement = nodeRecurTreeNode 
. createAndAddTreeNodeElement( ) ; 

createAndAddTreeNodeElement. setIld( " OD0002" ) ; // 赋 值 代码 
createAndAddTreeNodeElement. setName(" 部 门 2" ) ; // 赋 值 名 称 
createAndAddTreeNodeElement. setHasChildren( true) ; 
createAndAddTreeNodeElement. setIgnore Action( true) ; 

| else | 
// 其 余 情 况 , 即 当选 择 的 结 点 类 型 为 部 门 时 ,填充 下 级 人 员 结 点 


ITreeNodeElement createAndAddTreeNodeElement = nodeRecurTreeNode 


createAndAddTreeNodeElement. setIld( " P0001" ) ; // 赋 值 代码 
createAndAddTreeNodeElement. setName(" 人 员 1" ) ; // 赋 值 名 称 
createAndAddTreeNodeElement = nodeRecurTreeNode 

. createAndAddTreeNodeElement( ) ; 
createAndAddTreeNodeElement. setId( " P0002" ) ; // 赋 值 代 码 
createAndAddTreeNodeElement. setName(" 人 员 2" ) ; // 赋 值 名 称 


24) 定义 “onAction” 事件 ， 即 在 选择 当前 结 点 


时 触发 ， 如 图 4-212 所 示 。 


25) 按照 上 面 的 方法 添加 参数 并 做 元 素 的 参数 映射 ， 如 图 4-213 所 示 。 


图 4-212 ”修改 事件 属性 
26) 添加 动作 的 实现 逻辑 : 


图 4-213 


三 
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4 Events 
onAction SelectEle nadon 一 一 4 = 
onDrop path ear lele] 
onLoadChildren LoadChildren 


进行 参数 映射 


// 直 接 调用 CopyService API ,赋值 明细 


WDCopyService. copyCorresponding( ele, wdContext. currentDetailElement( ) ) ; 


27) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-214 所 示 。 


组 织 体系 
Pr 编码 : 
组 织 架 构 名 称 : 
>» SAPEYES01 
p SAPEYES02 
p SAPEYES03 


图 4-214 运行 效果 
28) 展开 公司 结 点 ， 并 选中 一 条 数据 ， 在 右 侧 可 以 看 到 结 点 的 明细 数据 ， 如 图 4-215 
所 示 。 


组 织 体系 


四 编码 : 0c0001 
x 组 织 架 构 名 称 : SAPEYES01 


™ 部门 2 
。 人员 1 
， 人 员 2 
v SAPEYES02 
> 部门 1 
> 部 门 2 
v SAPEYES03 
> 部 门 1 
> 部 门 2 


图 4-215 ”展开 后 的 效果 


4.3.5 表格 树 


表格 元 素 通 过 插入 行 编排 “RowArrangement”， 可 以 实现 树 元 素 的 功能 ， 此 时 的 树 也 会 
根据 实际 结 点 级 别 分 为 静态 树 与 动态 树 。 

开发 实例 : 

1) 将 表格 通过 “TreeByNestingTableColumn” 的 方式 实现 动态 多 级 结构 。 右 击 表格 
“Table”， 选 择 “ Insert RowArangement”， 在 类 型 中 选择 “TreeByNestingTableColumn”， 如 
图 4-216 所 示 。 

2) 右 击 “RowArrangement”， 依 次 选择 “Insert Header” FU “Insert TextView”， 搬 入 标 
题 和 文本 显示 区 ， 如 图 4-217 所 示 。 


4 |F TreeByNestingTableColumn [RowArrangement] 


a Table T Header1 [Header] 
4 [H TreeByNestingTableColumn [RowArrangement] TextViewl 
图 4-216 添加 结 点 后 效果 图 4-217 元 素 清单 
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3) 随后 ， 在 视图 中 创建 对 应 的 上 下 文 结构 ， 包 含 了 “HRInfoLst” 结 点 和 两 个 特性 ， 如 
图 4-218 所 示 。 
4) 右 击 “HRInfoLst”， 选 择 新 建 一 个 循环 结 点 ， 如 图 4-219 所 示 。 


New t| Node... 


Edit Context Mapping... ow Piui 


Recursion Node... 


图 4-218 ”特性 清单 图 4-219 添加 循环 结 点 的 菜单 选择 
5) 输入 循环 结 点 名 称 “RepHrs”， 单 击 “OK” 按钮 ， 如 图 4-220 所 示 。 


@© Manually 


Name: RepHrs 


Repeated Node HRInfoLst Browse... 


图 4-220 ”创建 循环 结 点 


6) 绑 定 结 点 属性 至 元 素 的 对 应 属性 ， 其 中 “TreeByNestingTableColumn” 列 用 于 显示 
“id” 字 段 ， 另 外 添加 一 列 显示 人 员 名 称 ， 如 图 4-221 所 示 。 

7) 添加 控制 , “TreeByNesting” 的 结 点 含有 以 下 3 个 控制 树 级 别 的 属性 。 

e“childrenLoaded”: 是 否 加 载 下 一 级 结 点 。 

e“expended”: 是 否 树 结 点 可 展开 。 

e“isLeaf”: 标明 该 结 点 是 否 是 最 后 一 级 。 

8) 绑 定 上 下 文 后 ， 创 建 一 个 默认 动作 “LoadChildren” 用 于 加 载 树 的 子 结 点 ， 如 图 4-222 
所 示 。 


| 人 员 信 息 架构 | 
| 和 名称 | 
> @id @name 
> @id @name 
> @id @name 


onLoadChildren LoadChildren 


K| 4-221 Al 4-222 修改 事件 属性 


9) 在 创建 动作 时 添加 两 个 参数 ， 分 别 为 字符 串 类 型 和 上 下 文 的 结 点 元 素 类 型 ， 用 于 记 
录 子 结 点 的 路 径 以 及 子 结 点 的 对 象 ， 如 图 4-223 所 示 。 


Details | Parameters 


Name Type 
path string 
ele com.sap.tc.webdynpro.progmodel.api IWDNodeElement 


到 4-223 ”添加 参数 定义 

10) 保存 所 有 修改 ， 右 击 “Outline” 清单 中 的 表格 列 ， 选 择 “Parameter Mapping” (如 
果 在 创建 动作 时 不 添加 对 应 参数 ， 则 无 法 进行 喘 射 )， 将 表格 列 中 的 树 与 创建 的 动作 中 的 参 
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数 进行 映射 ， 如 图 4-224 所 示 。 


4 TreeByNestingTableColumn | | Actions 
4 |onLoadChildren 一 | 一 |LeadChildren 
path | | path 


图 4-224 ”进行 参数 映射 

11) 接着 编写 动作 的 代码 逻辑 ， 在 完成 参数 映射 后 可 以 看 到 元 素 在 “onLoadChildren” 

动作 的 Java 编辑 絮 中 自动 传递 了 “path” 与 “nodeElement” 两 个 变量 ,分 别 代表 当前 层级 

路 径 与 当前 层级 的 元 素 。 通 过 两 个 参数 可 以 控制 不 同 的 级 别 在 展开 树 结构 时 显示 不 同 的 数 
据 。 参 考 代码 如 下 : 


IHRInfoLstElement element = (IHRInfoLstElement)ele; // 转 换 ele 
IHRInfoLstNode nodeRepHrs = element. nodeRepHrs( ) ; // 获 取 子 结 点 


nodeRepHrs. invalidate( ) ; // 清 空 数据 
int level = path. split('" RepHrs" ). length; // 根 据 含有 循环 结 点 结构 名 的 次 数 判 断 当 前 级 别 


if(1 == level) | 

// 第 一 级 展开 ,显示 所 有 公司 

IHRInfoLstElementcreateAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement 

(5 

createAndAddHRInfoLstElement. setId( "0001" ) ; 

createAndAddHRInfoLstElement. setName(" 公 司 1") ; 

createAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 

createAndAddHRInfoLstElement. setId( "0002" ) ; 

createAndAddHRInfoLstElement. setName(" 公 司 2" ) ; 

createAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 

createAndAddHRInfoLstElement. setId( "0003" ) ; 

createAndAddHRInfoLstElement. setName( "公司 3" ) ; 

| else if(2 == level) | 

// 第 二 级 展开 ,显示 该 公司 下 的 部 门 

String id = element. getld( ); // 根 据 Parameter Mapping 传递 的 ele 取得 当前 公司 代码 

String name = element. getName( ) ; //K 4%; Parameter Mapping 传递 的 ele 取得 当前 公司 名 称 

IHRInfoLstElementcreateAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 
//\oadChildren 


// 赋 值 Id , Name 

createAndAddHRInfoLstElement. setId( id + "01" ) ; 
createAndAddHRInfoLstElement. setName(" 部门 1" ) ; 
createAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 
createAndAddHRInfoLstElement. setId(id + "02" ) ; 
createAndAddHRInfoLstElement. setName(" 部门 2" ) ; 
createAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 
createAndAddHRInfoLstElement. setId(id + "03" ) ; 
createAndAddHRInfoLstElement. setName(" 部门 3" ) ; 


| else if(3 == level) | 

// 第 三 级 展开 ,显示 该 部 门下 的 人 员 

String id = element. getId() ; // 根 据 Parameter Mapping 传递 的 ele 取得 当前 部 门 代码 

String name = element. getName( ) ; //K 4% Parameter Mapping 传递 的 ele 取得 当前 部 门 名 称 

IHRInfoLstElementereateAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 
//\oadChildren 


// WME Id, Name 
createAndAddHRInfoLstElement. setId(id + "01" ) ; 
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createAndAddHRInfoLstElement. 


createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 


createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
createAndAddHRInfoLstElement. 
} 


setName(" 人 员 1"); 


createAndAddHRInfoLstElement. setExpended ( false) ; // 设 置 当 前 级 不 可 展开 
createAndAddHRInfoLstElement. setChildrenLoaded (false) ; // 设 置 不 可 加 载 子 结 点 
createAndAddHRInfoLstElement. setIsLeaf( true) ; // 设 置 该 级 为 末 级 


createAndAddHRInfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 


setld( id + "02" ); 
setName(" 人员 2"); 
setExpended ( false) ; 
setChildrenLoaded (false) ; 
setIsLeaf( true) ; 


createAndAddHR InfoLstElement = nodeRepHrs. createAndAddHRInfoLstElement( ) ; 


setId( id + "03" ) ; 
setName(" 人员 3") ; 
setExpended ( false) ; 
setChildrenLoaded (false) ; 
setIsLeaf( true) ; 


结 点 


FAIS gy 


断 级 别 后 创建 子 


$: 该 代码 是 针对 不 同 级 别 显示 不 同 的 子 


gE 


ae 


Zeb 


IHRInfoLstNode nodeHRInfoLst = wdContext. nodeHRInfoLst() ; 


内 容 ， 为 了 快速 构建 树 结构 ， 这 里 直接 判 
实际 封装 时 可 以 根据 “path” 与 “ele” 参 数 动态 构造 下 级 
12) 在 视图 的 “wdDoInit” 初 始 化 方法 中 添加 如 下 代码 : 


TO ,moO 


IHRInfoLstElementcreateAndAddHRInfoLstElement = nodeHRInfoLst. createAndAddHRInfoLstElement 
or // 创 建 一 条 根 记录 

createAndAddHRInfoLstElement. setId( "1001" ) ; 

createAndAddHRInfoLstElement. setName(" 集团" ) ; 


13) 保存 所 有 修改 ， 并 重新 编译 、 


运行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-225 所 示 。 


人 员 售 息 架 构 | 
| ee | 
|| 1001 = | 
0001 公司 1 
H ~ 000101 部 门 1 
加 。 00010101 人 员 1 
[| 。 00010102 AR2 
|_| 。 00010103 人 员 3 
|_| ~ j 部 门 2 
| | 。 00010201 人 员 1 
。 00010202 人 员 2 
。 00010203 人 员 3 
> 000103 部 门 3 
> 0002 公司 2 
|_| > 0003 公司 3 
| 


运行 效果 


4.3.6 文件 上 传 


文件 上 传 元 素 (FileUpload) 由 一 个 输入 框 和 一 个 固定 的 “Browse” 按 钮 组 成 ， 单 击 
214 


“Browse” 按 钮 ， 人 允许 用 户 从 本 地 硬盘 中 选择 文件 进行 上 传 。 
需要 特别 注意 的 是 ,文件 上 传 元 素 的 属性 中 并 没有 事件 的 定义 ， 所 以 单 击 “浏览 ” 按 
钮 也 不 会 触发 服务 器 端的 事件 处 理 器 ， 只 是 将 客户 端的 文件 存放 到 了 程序 的 上 下 文中 。 所 以 
文件 上 传 元 素 本 身 只 能 完成 一 般 上 传 需求 一 半 的 功能 ， 并 未 实现 存放 至 文件 服务 器 中 的 功 
能 。 一 般 情 况 下 ， 文 件 上 传 元 素 都 需要 额外 定义 一 个 按钮 ， 以 实现 文件 从 Web Dynpro 工程 
的 上 下 文 存放 到 指定 服务 器 的 功能 。 
它 包含 了 下 列 属 性 。 
e activateAccessKey: 设置 是 否 允 许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 
© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 
种 类 型 。 
e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 
e enabled: 控制 元 素 是 否 可 用 。 
e explanation: 设置 元 素 的 解释 文本 ， 设 置 后 元 素 文 本 下 方 会 出 现 一 条 绿色 的 下 画 线 。 
当 鼠 标 悬 停 在 文本 上 时 ， 会 弹出 解释 文本 的 说 明 。 
e resource; 用 于 控制 用 户 上 传 文件 所 存放 的 上 下 文 特性 ， 该 特性 类 型 必须 是 “ Resource” 
资源 类 型 ， 必 须 绑 定 上 下 文 。 
e state: 控制 元 素 的 显示 状态 ， 默认 有 “normal” 和 “required” 两 种 状态 。 在 选择 
“required” 后， 元 素 会 出 现 一 个 红色 星 号 进行 提醒 ， 但 逻辑 控制 仍 需要 编写 相关 代码 。 
e text: 控制 文件 上 传 的 显示 文本 。 
e tooltip: 控制 提示 消息 的 显示 文本 。 
e visible; 控制 元 素 是 否 可 见 。 
e width: 控制 元 素 的 显示 宽度 。 
开发 实例 : 
1) 打开 任 一 视图 (如果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “ Out- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 “ FileUpload” 文 件 上 
传 类 型 ， 输 入 ID 名称 ， 单 击 “OK” 按 钮 ， 如 图 4-226 所 示 。 


Ta 
FB New UI Element Siw See eS eT eh 
Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 
[All] a| | [All «| || [pFileUpload “ 
Action Active Components FormattedTextEdit 
Complex Adobe 图 FormattedTextView pe | 
Graphic Analytics Fn) FunctionKey 国 
Integration Business Graphics = Gantt 
Layout Business Intelligence &GeoMap 
Menu Calendar EZ] Group 
| Selection Mobile Add-Ons É HierarchicalCalendarMon 
Text _| | Office Integration E Hn = 
ID FileUpload 
图 4-226 ”选择 元 素 类 型 
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2) 进入 上 下 文 页 签 ， 创 建 一 个 新 的 上 下 [New 
文 特性 。 右 击 “ Context” 根 结 点 ， 选 择 Migrate Context Tree 
“New” 一 “Attribute”， 如 图 4-227 所 示 。 References 

3) 在 弹出 的 对 话 框 中 输入 特性 的 名 称 
“resource”， 随 后 单 击 “Browse” 按 钮 ， 选 择 
特性 类 型 ， 如 图 4-228 所 示 。 


陋 一 
B Context Attribute 
Create a context attribute 


Specify whether you want to create the element manually or with 
context mapping, 


Create With 
© Mapping 
Model Binding 
Structure Binding 
@ Manually 


Name: resource 


ee 


Calculated 


Ly 


4-228 输入 特性 名 称 


4) 在 弹出 的 对 话 框 的 类 型 列表 中 找到 “com. sap. ide. webdynpro. uielementdefinitions” 


© Simple Type 
© Core Data Type 
© Java Native Type 


4 ® Dictionaries 
4 G Local Dictionary 
> 出 com.sap.dictionary.predefined.currency 
> 出 com.sap.dictionary.predefined.objecttypes 
> 出 com.sap.demo.mydynp04.wd.ddic 


4 | com.sap.ide.webdynpro.uielementdefinitions | 
AttributePointer 
[M BarColor 
[M BreadCrumbBehavior 
BreadCrumbSize 


图 4-229 选择 类 型 
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5) 在 该 包 的 类 型 列表 中 选中 “resource” 资 源 类 型 ， 单 击 “OK” 按 钮 完成 特性 的 类 型 
选择 ， 单 击 “Finish” 按 钮 完成 特性 的 创建 ， 如 图 4-230 所 示 。 


@ Manually 


Name: resource 


Type: |com.sap.ide.webdynpro.uielementdefinitions.Resource > Browse... 


图 4-230 创建 特性 


6) 选中 视图 中 的 文件 上 传 元 素 ， 将 创建 的 特性 与 元 素 属性 进行 绑 定 ， 如 图 4-231 
所 示 。 

7) 添加 “人 解析” 按钮， 并 创建 默认 动作 解析 文件 ， 如 图 4-232 所 示 。 注 : 在 实际 项 目 
实施 过 程 中 ,“ 解 析 ” 按 钮 更 多 的 是 完成 将 文件 解析 并 存放 至 如 FTP 服务 器 的 文件 目录 中 。 


HA... [EF] 
resource B resource 
图 4-231 修改 属性 图 4-232 运行 效果 


8) 保存 所 有 修改 后 ， 进 入 Java 编辑 器 ， 在 按钮 动作 中 编写 文件 人 处理 逻 辑 ， 添 加 下 列 
代码 : 


// 获 取 resource 属性 

IWDResource resource = wdContext. currentContextElement( ). getResource( ) ; 
if( resource! = null) | 

String resourceName = resource. getResourceName( ) ; 

wdComponentAPI. getMessageManager( ). reportSuccess ( 

"打印 ResourceName;" + resourceName) ; 


// 以 下 为 解析 TxT 文件 

try | 

InputStream read = resource. read(true) ; //resource 读 取 文件 输入 流 
InputStreamReader reader = new InputStreamReader( 

read, "GBK") ; /根据 文件 输入 流 构造 Reader 


BufferedReader bufferedReader = new BufferedReader( reader) ; 
String lineTxt = null; 


while( (lineTxt = bufferedReader. readLine() ) ! = null) f // 逐 行 解析 文件 
wdComponentAPI. getMessageManager( ). reportSuccess( 

"文件 内 容 :" +lineTxt) ; // 打 印 文 件 内 容 

| 

read. close() ; // 关 闭 文件 输入 流 


| catch( IOException e) | 

//TODO Auto - generated catch block 

//e. printStackTrace( ) ; 

// 解 析 文 件 异 常 

wdComponentAPI. getMessageManager( ). reportException(" 解 析 的 文件 异常 1" ) ;| 
| else} 

// 未 浏览 选择 文件 

wdComponentAPI. getMessageManager( ). reportException( "解析 的 文件 为 空 1" ); 
| 


9) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-233 所 示 。 
10) 单 击 “ 浏 览 ” 按 钮 ， 选 择 文件 ， 随 后 单 击 “ 解 析 ” 按 钮 ， 如 图 4-234 所 示 。 
11) 单 击 “ 解 析 ” 按 钮 后 可 以 看 到 打印 的 消息 ， 如 图 4-235 所 示 。 
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打印 ResourceName: 新 建文 本 文档 (8).txt 


[ EE [EF] CAUsersizhxiDesktop\are | ae | E 文件 内容 :测试 的 文本 文件 
文件 内 容 :测试 的 文件 内 容 ! 
图 4-233 ”运行 效果 图 4-234 ”选择 浏览 文件 图 4-235 i “HI” 
按钮 后 的 效果 


4.3.7 文件 下 载 


文件 下 载 元 素 ( FileDownload) 由 一 个 标题 和 一 个 链接 组 成 ， 根 据 不 同 的 动作 属性 配 
置 ， 用 户 可 以 直接 打开 链接 对 应 的 服务 器 端的 文件 或 者 转 存 至 用 户 的 本 地 硬盘 中 。 与 文件 上 
传 元 素 一 样 ， 文 件 下 载 元 素 的 核心 也 是 使 用 一 个 类 型 为 “Resource” 资 源 的 上 下 文 特 性 对 文 
件 进 行 处 理 。 文 件 下 载 也 同样 没有 事件 绑 定 ， 从 逮 辑 角度 看 ， 用 户 单 击 链接 只 是 将 文件 下 载 
元 素 绑 定 的 上 下 文中 的 文件 资源 进行 处 理 ， 所 有 操作 都 在 客户 端 完 成 。 文 件 下 载 元 素 包 含 下 
列 属性 。 

1) activateAccessKey: 设置 是 否 允许 快捷 键 (使 用 “Alt” 键 与 首 字母 触发 默认 事件 ) 。 

2) behavior, 控制 用 户 在 单 击 文件 下 载 元 素 后 的 反馈 动作 ， 默 认 有 3 个 选项 :“al- 
lowSave” 人 允许 保存 ， 在 用 户 单 击 后 会 首先 弹出 一 个 “打开 ”或 “保存 ”对 话 框 ， 即 允许 用 
户 直接 使 用 默认 程序 打开 文件 或 者 直接 男 存 至 本 地 硬盘 中 ; “auto” 自 动 ， 程 序 会 根据 文件 
资源 的 类 型 自动 进行 响应 ， 表 4-4 为 部 分 文件 类 型 的 响应 方式 清单 ， 其 中 最 后 一 列 的 “是 ” 
与 “ 否 ” 表 示 是 否 会 在 新 窗口 中 打开 ; “openInPlace” 表示 对 应 文件 将 使 用 用 户 客户 端的 默 
认 软 件 在 同一 窗口 中 打开 。 


表 4-4 部 分 文件 类 型 的 响应 方式 清单 


常量 文件 扩展 名 资源 类 型 ( W3C 标准 ) 新 窗口 打开 
APPLET “jar” application/x — java 是 
CSS “css” text/css T 
poc |, ee : 
FLASH “swf” application/x — shockwave — flash T 
GIF_IMAGE “gif” image/gif m 
HTML “html” text/html T 
JAVA “java” application/x — java T 
JAVA_SCRIPT “js” text/js 否 
JPG_IMAGE “jpg” image/jpeg 否 
PDF “pdf” application/pdf 否 
PNG “png” image/jpeg 
m w | ine ee : 
PS “ps” application/ postscript T 
RTF “nf” application/rtf T 
SVG “svg” image/svg + xml 否 
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(2) 


常量 XFER 资源 类 型 (W3C 标准 ) 新 窗口 打开 
TXT “txt” text/text 否 
UNKNOWN 一 = 是 
VML “vml” text/vml E 
WD_APPLICATION 一 三 T 


application/vmd. ms — excel 


u gan = 
XIS = application/x — msexcel H 
XML “xml” text/xml T 
XML_CONFIGURATION “xml” text/xml 是 


3) contextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ” 
3 种 类 型 。 

4) contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

5) design; 控制 链接 文本 的 显示 风格 ,默认 有 标准 显示 和 增强 显示 两 种 类 型 其 中 增 
强 类 型 即 为 文本 加 粗 显示 。 

6) enabled; 控制 元 素 是 否 可 用 。 

7) imageFirst: 控制 显示 的 链接 图 标 是 否 位 于 文本 前 面 ， 布 尔 型 属性 。 

8) imageHeight: 控制 文件 下 载 元 素 中 链接 图 标的 高 度 。 

9) imageSource: 控制 文件 下 载 元 素 中 链接 图 标的 来 源 (文件 目录 位 置 ) 。 

10) imageWidth: 控制 文件 下 载 元 素 中 链接 图 标的 宽度 。 

11) resource; 用 于 控制 用 户 下 载 文件 所 对 应 的 上 下 文 特性 。 该 特性 类 型 必须 是 “ Re- 
source” 资源 类 型 ， 必 须 绑 定 上 下 文 。 

12) target: 控制 弹出 页 面 的 具体 位 置 ， 如 可 以 使 弹出 页 面 在 指定 的 窗口 中 打开 。 

13) text: 控制 文件 上 传 的 显示 文本 。 

14) textDirection : 控制 链接 文本 的 排列 顺序 ， 默认 有 3 个 选项 : 继承 自 父 元 素 、 从 左 
往 右 和 从 右 往 左 。 

15) tooltip: 控制 提示 消息 的 显示 文本 。 

16) type: 控制 文件 下 载 元 素 中 链接 的 显示 风格 ， 默 认 有 以 下 4 种 风格 : 

o 功能 型 : 显示 默认 的 链接 风格 ， 默 认为 蓝 色 带 下 画 线 文本 。 

。 导航 型 : 显示 为 已 访问 过 的 链接 颜色 ， 文 本 带 下 画 线 。 

© 报告 型 : 显示 默认 的 链接 风格 ， 文 本 不 带 下 画 线 。 

e 结果 型 : 显示 为 已 访问 过 的 链接 颜色 ， 文 本 不 带 下 面 线 。 

17) visible: 控制 元 素 是 否 可 见 。 

18) width: 控制 元 素 的 显示 宽度 。 

开发 实例 : 

1) 以 上 一 节 中 的 文件 上 传 元 素 的 实例 为 基础 ， 增 加 一 个 文件 下 载 元 素 ， 能 实现 用 户 在 
上 传 文 件 后 即 能 看 到 是 否 上 传 成 功 以 及 对 应 文件 下 载 的 效果 。 首 先 打 开 文件 上 传 的 视图 
(如 需 重新 创建 ， 请 参考 上 一 节 “ 文 件 上 传 ” 中 开发 实例 的 步 又) ， 右 击 “Outline” 元 素 清 
单 中 的 “RootElement” 根 结 点 ， 选 择 插 入 子 对 象 ， 选 择 “FileDownload” 文 件 下 载 类 型 Hi 
入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-236 所 示 。 


279 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category 


Library 


UI Element 


[all] 

Action 
Complex 
Graphic 
Integration 
Layout 
Menu 
Selection 
Text 
Toolbar 


[All] 

Active Components 
Adobe 

Analytics 

Business Graphics 
Business Intelligence 
Calendar 

Mobile Add-Ons 
Office Integration 


Pattern Development 


(E3 FileDownload 


Ë FileDropTarget 

E% FileUpload 
FormattedTextEdit 
FormattedTextView 
(Fn) FunctionKey 
Gantt 

&GeoMap 

E7] Group 


| 


图 4-236 ”选择 元 素 类 型 
2) 此 时 会 用 到 3 个 元 素 : 文件 上 传 、 上 传 按 钮 和 文件 下 载 ， 如 图 4-237 所 示 。 注 意 ， 
文件 上 传 是 将 文件 从 用 户 客 户 端 上 传 至 Web Dynpro 程序 的 上 下 文中 ， 而 上 传 按 钮 是 将 上 下 
文中 的 文件 存储 至 服务 器 端 。 
3) 进入 上 下 文 页 签 ， 创 建 一 个 新 的 上 下 文 特性 ， 用 于 在 文件 下 载 元 素 中 显示 对 应 的 文件 
o fiii “Context” WRR, PEE “New” — “Attribute”, WEI 4-238 所 示 。 


4 [| RootElement New oO Wate 
BB FileUpload Migrate Context Tree bs 
ca TER 4 References > 
[3% FileDownload 


图 4-237 ”元素 列表 图 4-238 创建 结 点 的 菜单 选择 


A) 在 弹出 的 对 话 框 中 输入 特性 的 名 称 “fleName”， 类 型 使 用 默认 的 字符 串 类 型 ， 单 击 
“Finish” 按钮 ， 如 图 4-239 所 示 。 


Create a context attribute 


Specify whether you want to create the element manually or with 
|| context mapping, 


Create With 
© Mapping 
Model Binding 
Structure Binding 
@ Manually 


Name: [fileName] 


Type: [string 
Calculated 


Ly 


4-239 输入 特性 名 称 
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5) 保存 所 有 修改 ， 完 成 了 上 下 文 特性 的 创建 ， 如 图 4-240 所 示 。 注 : “resource” 特性 
是 上 一 小 节 中 使 用 “文件 上 传 ”时 已 经 创建 的 特性 ， 类 型 是 “com. sap. ide. webdynpro. uiele- 
mentdefinitions” 中 的 “resource” 资源 类 型 。 

6) 选中 视图 中 的 文件 下 载 元 素 ， 将 创建 的 特性 与 元 素 属性 进行 绑 定 。 其 中 “resource” 
属性 直接 绑 定 文件 上 载 元 素数 据 源 ， 即 通过 文件 上 传 元 素 得 到 的 文件 资源 同时 也 成 为 了 文件 
下 载 元 素 的 文件 资源 ， 文 件 下 载 的 文本 则 显示 出 了 上 传 文件 的 文件 名 。 另 外 ， 将 “behav- 
iour” 属 性 改 为 “allowSave”， 人 允许 用 户 直 接 操作 文件 ， 如 图 4-241 所 示 。 


E3 FileDownload 
General | behaviour 
contextMenuBehaviour inherit* 
LS contextMenuld 
design standard* 
enabled true 
imageFirst true 
imageHeight 
imageSource a 
imageWidth 
4 O Context p resource B resource 
B fileName“ target 
B resource text B fileName 
图 4-240 ”特性 清单 图 4-241 修改 属性 
7) 在 开发 工具 中 的 页 面 预览 ， 如 图 4-242 | [RE] Gina 
所 示 。 Er 


8) 在 “解析 ”按钮 的 事件 处 理 方法 中 增加 
下 列 代码 ， 用 于 读 取 上 传 的 文件 名 : 
// 这 段 代码 需 放 在 方法 实现 的 最 前 面 
IWDResource resource = wdContext. currentContextElement( ). getResource( ) ; 
if(resource! = null) | 


图 4-242 ”运行 效果 


String resourceName = resource. getResourceName( ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess( 

"打印 ResourceName;" + resourceName) ; 

//NAEL fileName 

wdContext. currentContextElement( ). setFileName(resourceName ) ; 
// 以 下 为 文件 上 传 元 素 章 节 中 原 解 析 TxT 文件 代码 

Hees 


9) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 上 传 、 下 载 文件 的 测试 ， 如 
图 4-243 所 示 。 

10) 单 击 “ 浏 览 ”按钮 ， 从 本 地 文件 中 选择 “测试 文本 . txt”， 随 后 单 击 “ 解 析 ” 按 
钮 ， 文 件 下 载 链接 点 亮 ， 并 显示 上 传 文件 的 文件 名 。 单 击 文件 名 链接 ， 即 可 将 文件 另存 至 本 
地 硬盘 目录 中 ， 如 图 4-244 所 示 。 


Aa.. pEr] HA... 测试 文本 .txt 
图 4-243 ”运行 效果 图 4-244 ”运行 效果 


注 : 实际 使 用 时 ， 上 传 按钮 会 多 增加 一 步 ， 将 文件 存放 至 服务 器 端 。 而 在 下 载 文件 元 素 
的 初始 化 处 理 中 ， 也 同样 会 增加 将 服务 器 端 文件 读 取 并 存放 至 Web Dynpro 的 上 下 文中 的 动 
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作 。 本 实例 中 未 体现 这 些 步 又 ， 各 位 读者 可 以 在 系统 环境 允许 的 条 件 下 进行 测试 。 
4.3.8 视图 容器 


在 实际 的 项 目 中 ， 尤 其 是 跟 JPEE 实施 的 项 目 做 对 比 ， 可 以 发 现 WDA 在 设计 开发 过 程 
中 占据 独特 的 优势 ， 由 于 WD4J 本 身 就 是 对 J2EE 的 封装 ， 并 且 是 在 JEE 基础 之 上 的 一 层 架 
构 ， 因 此 其 在 设计 、 开 发 ， 特 别 是 页 面 的 设计 开发 过 程 中 更 具 模板 化 与 快速 定制 的 特点 ， 即 
开发 人 员 可 以 根据 后 台 的 数据 模型 快速 地 定制 符合 需求 的 前 台 展 现 。 那 么 除 此 之 外 ，WD4j 
的 设计 也 具备 较 高 的 可 重用 性 ， 对 于 很 多 页 面 都 有 的 设计 ， 可 以 抽象 成 一 个 界面 ， 并 且 所 有 
的 页 面 来 引用 ， 视 图 容器 就 是 实现 此 类 功能 的 空间 。 它 包含 下 列 属性 。 

© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 


种 类 型 。 
® contextMenuld : 设置 上 下 文 菜单 的 唯一 标识 。 tS [LocalDevelopment] mydynp06 
= 4 仙 Web Dynpro 
e enabled: 控制 元 素 是 否 可 用 o ie] Re 
e tooltip: 控制 提示 消息 的 显示 文本 。 Models 
Component Interfaces 
e visible, 控制 元 素 是 否 可 见 。 iai concoa 
开发 实例 ， > |e Dynp06_01Comp| 
1) 新 建 一 个 Web Dynpro 项 目 “mydynp06”， 并 创建 对 应 图 4-245 “创建 的 
的 组 件 、 视 图 和 窗口 ， 如 图 4-245 所 示 。 Web Dynpro 项 目 结构 


2) 编辑 默认 创建 的 视图 ， 新 建 审 批 历史 的 数据 结 点 并 在 页 面 生成 表格 ， 如 图 4-246 
所 示 。 


审批 历史 
m| 审批 人 市 批 结果 SHER | ses 
@apper @appres @appcom @appdate 
@apper @appres @appcom @appdate | 
@apper @appres @appcom @appdate | 
| 
i 


Kl 4-246 预览 效果 


3) 接着 将 组 件 添 加 至 公共 部 分 ， 右 击 “Dynp06 _01Comp” 并 选择 “Add to Public 
Part”， 如 图 4-247 所 示 。 
4) 在 弹出 的 对 话 框 中 单 击 “New” 按 钮 ， 新 建 一 个 公共 部 分 ， 如 图 4-248 所 示 。 


Public Parts of 'mydynp06 [demo.sap.com]' "ah 
Select a Public Part Soy 
4 Hy Components 
“la one Open Data Modeler 
R Add to Public Part 
Sæ C 里 Delete prn 
I Copy 
图 4-247 ”添加 公共 部 分 的 菜单 选择 图 4-248 ”创建 公共 部 分 对 话 框 
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5) 输入 名 称 ， 单 击 “Finish” 按 钮 ， 如 图 4-249 所 示 。 
6) 创建 完成 公共 部 分 后 ， 选 中 该 对 象 ， 随 后 单 击 “Finish” 按钮 ， 如 图 4-250 所 示 。 


Public Part 


Enter the public part name and select a purpose. You can 
also enter a caption and description. 


Name: api 


[E5 api 


Purpose: COMPILATION X 


Caption: 


Description: <^ 


© 


| < Beck aniani) 


14-249 输入 公共 部 分 信息 图 4-250 选择 公共 部 分 


7) 切换 到 DI 透视 网， 在 “mydynp06” 项 目的 公共 部 分 中 可 以 看 到 对 应 的 “api”， 如 
图 4-251 所 示 。 

8) 接着 创建 “mydynp05” 项 目 到 “mydynp06” 的 依赖 。 双 击 打 开 “mydynp05” 后 ， 
在 “Dependencies” 依 赖 中 ， 单 击 “Add” 按 钮 ， 如 图 4-252 所 示 。 


*ma mydynp05 


Overview Dependencies | Public Parts| Child DCs Permissions | Folders| Cus 


Required DCs 

Specify the list of DCs required for this DC 
号 4 tc/aii/base/offline/facade 
Ta tc/bl/exception/lib 
Da tc/bl/logging/api 
Ta tc/cmi 
Ia tc/ddic/runtime/facade 
Sq tc/wd/api Resolve All | 


*ma MydyNpOG 


Overview | Dependencies | Public Parts | Child DCs | Permis: 


Defined Public Parts 
Specify the list of public-parts for this DC 


图 4-251 在 DI 透视 图 中 示例 图 4-252 ”添加 工程 的 依赖 
9) 在 弹出 的 对 话 框 中 选择 “mydynp06”， 单 击 “Finish” 按 钮 ， 如 图 4-253 所 示 。 


New Required DCs: Dependency Details: 
4 “Bn mydynp06| F] Design Time 
E api 
F] Deploy Time 
F] Runtime strong X 


@ | a) (Gee 


N 


4-253 ”选择 依赖 的 具体 属性 
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10) 依赖 配置 完成 后 “mydynp05” 项 目 ， 新 建 视 图“Dynp05_01Comp_03View”， 
随后 右 击 “Outline” a “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 “ View- 
ContainerUIElement” 视 图 容器 类 型 ， 输 入 ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-254 所 示 。 

11) 完成 元 素 添 加 后 ， 可 以 在 视图 中 看 到 预览 效果 ， 如 图 4-255 所 示 。 


4\(_] RootElement| 
问 ViewContainerUIElement 


12) 双击 打开 “mydynp05” 中 对 应 的 窗口 MHA BAY [二 | 
Instance” 瞬 入 一 个 组 件 实例 的 接口 视图 ,在 弹出 的 对 话 框 中 添加 


图 4-254 元素 清单 图 4-255 ”预览 效果 
容器 ， 如 图 4-256 所 示 。 
13) AFAA, W “Embed Interface View Of a Component 
2 “ ” — 图 4- 256 TRA 
对 应 组 件 ， 单 击 “Add” 按 钮 ， 如 图 4-257 所 示 。 视图 后 的 预览 效果 


Embed Interface View of a Component Instance 


Select the component interface view that you want to embed into 'Dynp05_01Comp_01Win' . 


CA Component Instances Add.. 


4-257 选择 对 应 接口 组 件 


14) 在 弹出 的 对 话 框 中 选 
图 4-258 所 示 。 


择 “Dynp06_01Comp” 组 件 ， 随 后 单 击 “OK” 按 钮 ， 如 


H 
Choose Web Dynpro Component Erim 
Es 


Select a Web Dynpro component or component interface definition 


喝 Dynp05_01Comp - com.sap.demo.mydynp05.wd.comp.dynp05_01co! 
|e) Dynp06_01Comp - com.sap.demo.mydynp06.wd.comp.dynp06_01co 


mn j 


图 4-258 ”选择 对 应 组 件 


15) 输入 对 应 名 称 与 相关 属性 ， 随 后 单 击 “Finish” 按 钮 ， 如 图 4-259 所 示 。 
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Name Dynp06Comp 


Used Web Dynpro Component com.sap.demo.mldynp06.wd.comp.dyn Browse... 


Lifecycle | createOnDemand 7, | 


图 4-259 输入 引用 组 件 名 称 


16) 选中 新 添加 的 接口 视图 ， 随 后 单 击 “Finish” 按 钮 ， 如 图 4-260 所 示 。 
17) 完成 配置 后 ， 可 以 在 模型 编辑 器 中 看 到 舱 入 后 的 状态 ， 如 图 4-261 所 示 。 


4 C Component Instances 
4 ah Dynp06Comp <Dynp06_01Complnterface> 
[E Dynp06_01CompInterfaceView | 


图 4-260 选择 接口 视图 图 4-261 上 般 入 后 预览 效果 


18) 分 别 编译 和 部 署 “mydynp06” 和 “mydynp05” 项 目 并 运行 ， 可 以 看 到 容 需 中 显示 
了 “mydynp05” 中 视图 的 内 容 ， 如 图 4-262 所 示 。 


审批 历史 l . : 
Tal 审批 人 审批 结果 TREN 审批 日 期 


图 4-262 ”运行 效果 
4.4 特殊 元 素 
4.4.1 定时 器 


篆 用 的 页 面 定 时 触发 右 〈TimedTrigger) 在 页 面 中 是 不 可 见 的 ， 触 发 的 时 间 间 隅 根据 延 
时 参数 (delay) 来 进行 设置 。 


它 包含 以 下 属性 。 
o delay: 触发 需 执行 的 延 时 间隔 ， 以 秒 为 基准 单位 ， 当 延 时 设置 为 “0” 时 ， 定 时 触发 
器 将 会 关闭 。 


e enabled; 控制 元 素 是 否 可 用 。 
© onAction 事件 : 用 于 绑 定 定时 触发 的 动作 。 
开发 实例 : 
1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步 又 ) ， 右 击 “Our- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 关键 字 下 拉 列 表 类 型 ， 
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输入 ID 名 称 ， 单 击 “OK” 按 钮 ， 如 图 4-263 所 示 。 
2) 建立 上 下 文 特性 “delay”， 类 型 为 整 型 ， 如 图 4-264 所 示 。 


4 © Context 
ac RootElement _ B delay 
|@? TimedTrigger| 
图 4-263 元素 清 单 图 4-264 上 下 文清 音 


3) 绑 定 上 下 文 特性 至 定时 器 的 延 时 属性 中 ， 如 图 4-265 所 示 。 
4) 创建 定时 器 触发 的 动作 “Triggered”， 如 图 4-266 所 示 。 


4 Events 
delay B delay onAction Triggered 
图 4-265 ”修改 属性 图 4-266 ”修改 事件 属性 
5) 编写 动作 逻辑 ， 代 码 如 下 : 
wdComponentAPI. getMessageManager ( ) .reportSuccess ( " TimeTriggered!" + Sys- 
tem. currentTimeMillis( ) ) ; 
6) 编写 初始 化 代码 ， 设 定 delay 值 : 
wdContext. currentContextElement( ). setDelay(2) ; // 初 始 化 时 设 定 延 时 时 间 为 2 秒 


7) 保存 所 有 修改 后 ， 编 译 并 部 署 项 目 ， 运 行 后 就 能 看 到 
测试 效果 。 页 面 每 隔 两 秒 会 打印 当前 时 间 ， 如 图 4-267 到 4-267 运行 效果 
所 示 。 


4.4.2 图 片 

图 片 包 含 以 下 属性 。 

e adjustImageSize: 控制 图 像 尺 寸 是 否 可 调整 。 

e border; 控制 边框 大 小 。 

© contextMenuBehaviour; 设置 上 下 文 荣 单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 

种 类 型 。 

e contextMenuld: 设置 上 下 文 菜单 的 唯一 标识 。 

e enabled; 控制 元 素 是 否 可 用 。 

e height; 指定 图 像 高 度 。 

e isDecorative: 控制 图 片 是 否 进行 修饰 。 

e isDragHandle: 控制 是 否 可 以 进行 拖 忠 。 

e source; 控制 图 片 的 路 径 。 

e visible; 控制 元 素 是 否 可 见 。 

e width; HERR TERE o 

开发 实例 : 

1) 打开 任 一 视图 (如果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 “Out- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插 入 子 对 象 ， 选 择 关键 字 下 拉 列 表 类 型 ， 
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输入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-268 所 示 。 
2) 建立 上 下 文 特性 ， 类 型 为 字符 串 ， 如 图 4-269 所 示 。 


4 | | RootElement 


Ey FileUpload a © Context 
mi Button B fileName _ ~ 
[$ FileDownload _. [B _imageSource | 

图 Image| a B resource 


图 4-268 ”元素 清单 图 4-269 上下文 清单 


3) 绑 定 上 下 文 结 点 至 元 素 的 “source” 属性 中 ， 如 图 4-270 所 示 。 
4) 完成 所 有 修改 后 ， 预 览 视图 ， 如 图 4-271 所 示 。 


- 浏览... | EA] @filename | |x| 
source B imageSource 


Al 4-270 修改 属性 图 4-271 运行 效果 


5) 解析 时 添加 处 理 资源 的 代码 : 


String url = resource. getUrl( WDFileDownloadBehaviour. OPEN_INPLACE. ordinal( ) ) ;// 图 片 显 示 
wdContext. currentContextElement( ). setImageSource (url) ; 
6) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 。 单 击 “ 浏 览 ” 按 钮 ， 
选择 图 片 后 ， 单 击 “ 解 析 ” 按 钮 ， 如 图 4-272 所 示 。 


图 4-272 ”运行 效果 


注 : 本 例 在 FileUpload 控件 实例 之 上 ， 图 片 支持 GIF、JPG、PNG 等 格式 。 
7) 解析 逻辑 的 全 部 代码 如 下 : 


TWDResource resource = wdContext. currentContextElement( ). getResource( ) ; 
if( resource! = null) f 

String resourceName = resource. getResourceName( ) ; 

wdComponentAPI. getMessageManager( ). reportSuccess ( 

"打印 ResourceName;" + resourceName) ; 

wdContext. currentContextElement( ). setFileName(resourceName ) ; 


7X7 以 下 为 解析 TxT 文件 
try | 
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//resource 读 取 文件 输入 流 


InputStream read = resource. read(true) ; 
InputStreamReader reader = new InputStreamReader( 
read, "GBK" ) ; // 根 据 文件 输入 流 构造 Reader 
BufferedReader bufferedReader = new BufferedReader( reader) ; 

String lineTxt = null; 

while( (lineTxt = bufferedReader. readLine() )!=null) | // 逐 行 解析 文件 
//wdComponentAPI. getMessageManager( ). reportSuccess( 

AA" 文件 内 容 :" + lineTxt) ; // 打 印 文 件 内 容 

| 

// 图 片 显示 

String url = resource. getUrl( WDFileDownloadBehaviour. OPEN_INPLACE 

. ordinal() ) ; 

wdContext. currentContextElement( ). setImageSource (url) ; 

read. close() ; // 关 闭 文件 输入 流 

| catch( IOException e) | 

//TODO Auto - generated catch block 

//e. printStackTrace( ) ; 

wdComponentAPI. getMessageManager( ). reportException(" 解析 的 文件 异常 1" ); /解析 文件 
| 


| else} 


wdComponentAPI. getMessageManager( ). reportException(" 解 析 的 文件 为 空 1" ) ; // 未 浏览 选择 文件 


| 


异常 


4.4.3 


章节 步 又) ， 右 击 “Outline” 元 素 清 单 中 的 “RootElement” 根 结 点 ， 


网 页 框 染 


IFrame 是 舰 在 页 面 内 的 框架 元 素 ， 可 以 显示 HTML 等 Web 资源 ， 通 过 设置 绑 定 的 URL, 
控件 能 够 自动 进行 内 容 切 换 。 
它 包含 下 列 属性 。 

e height; 设置 高 度 。 

e lifeCycle: 设置 生命 周期 。 


postParameters; 当 postParameters 有 值 时 ， 请 求 以 POST 方式 传递 
scrollingMode; 设置 [Frame 是 和 否 带 滚动 条 。 

source: 控制 URL 地 址 。 

supportsResizing: 是 否 支 持 自 动 调整 大 小 。 

width; 设置 宽度 。 


开发 实例 : 
1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 da 


选择 插入 子 对 象 ， 选择 “IFrame” 框 架 类 型 ， 输 入 ID 名 称 ， 随 后 单 击 ”图 4-273 ”元素 清单 
“OK” 按 钮 ， 如 图 4-273 所 示 。 
2) 建立 上 下 文 特性 “url ， 类 型 为 字符 串 类 型 ， 如 图 4-274 所 示 。 
3) 随后 绑 定 该 特 ; 竹 到 元 素 的 “ source” 属性 中 ， 如 图 4-275 所 示 。 
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a © Context 
[o url] 
source B url 
图 4-274 上 下 文清 单 图 4-275 修改 属性 


4) 初始 化 赋值 url : 


// 获 取 request 对 象 

TWDRequest request = WDProtocolAdapter. getProtocolAdapter( ) 
. getRequestObject() ; 

// 初 始 化 设置 url 

String url = "http://" + request. getServerName( ) +" ;" 

+ request. getServerPort() +"/"; 

wdContext. currentContextElement(). setUrl( url) ; 


5) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-276 所 示 。 


EJ SAP NetWeaver Application Server Java = 


EE T SAP Library 
E f SAP Library contains the complete documentation for SAP NetWeaver Application Server 
El Java. You can access it by choosing SAP NetWeaver. 


F SAP NetWeaver Administrator 


A powerful administration, configuration and monitoring tool, which bundles key 
administrative tasks to keep your SAP NetWeaver system landscape running. SAP 
NetWeaver Administrator can be used in a central or local scenario. Here you access the 
local NetWeaver Administrator. 


System Information 

Gli System information provides administrators with an overview of the system configuration 
and its state. It shows all of the system's instances and processes, their current state and 
important parameters (such as ports) that may be required for support cases, as well as 
the versions of the components installed. 


a Web Services Navigator 
Web Services Navigator is a tool that gives you a short overview of a specific Web service 

based on its WSDL, and enables you to test your Web service by creating and sending a 
client request to the real end point. 
User Management 

} The user management administration console provides administrators with the functions 

"| they need to manage users, groups, roles, and user-related data in the User Management 
Engine (UME). Users without administrator permissions can use it to change their user 
profile. X 


图 4-276 运行 效果 
ìt: 在 Web Dynpro 中 IFrame 已 被 标记 为 过 时 的 元 素 ， 除 特殊 情况 下 不 建议 使 用 。 
4.4.4 Web 部 件 


在 NetWeaver 7. 3 版 本 之 后 增加 了 Web 部 件 (WebWidget) GR, CRA UIA Ae 
X HTML 内 容 ， 并 且 可 以 添加 脚本 开发 (JavaScript，JS) 。 对 于 Web Dynpro 中 标准 元 素 无 法 
实现 的 功能 ， 该 元 素 实 现 较 大 的 扩展 与 延伸 。 

Web 部 件 包含 了 下 列 属性 。 

© contextMenuBehaviour; 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ”3 

种 类 型 。 

e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 

e enabled: 控制 元 素 是 否 可 用 。 

e hml: 自 定义 HTML 内 容 。 

e scriptOnLoad: 元 素 加 载 或 产生 请 求 时 执行 脚本 。 
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e scriptOnUnLoad; 页 面 关闭 或 元 素 销毁 时 执行 的 脚本 。 

e style: 页 面 样式 。 

e tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

开发 实例 : 

1) 打开 任 一 视图 (如果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 『 RootEement 
前 章节 步骤 ) ， 右 击 “ Outline” 元 素 清单 中 的 “RootElement” 根 结 一 
点 ， 选 择 插 入 子 对 象 ， 选 择 “WebWidget” 类 型 ,输入 ID 名 称 ， 随 ” 图 4-277 元 素 清单 
后 单 击 “OK” 按 钮 ， 如 图 4-277 所 示 。 

2) 建立 上 下 文 特性 ， 分 别 用 于 存放 网 页 内 容 、 加 载 脚本 和 显示 样式 ， 如 图 4-278 
所 示 。 

3) 绑 定 属性 至 元 素 ， 如 图 4-279 所 示 。 


4 O Context html B html 
i scriptOnLoad B script 
script scriptOnUnload 
style style B style 
图 4-278 上 下 文清 单 图 4-279 ”修改 属性 
4) 在 视图 的 “wdDoInit” 初 始 化 方法 中 添加 以 下 代码 : 
/赋值 html 


wdContext. currentContextElement( ). setHtml( 

"<button type = button id = button > Show Hello World </button >") ; 

// 赋 值 脚本 

wdContext 

. currentContextElement( ) 

. setScript( "var btn = UCF_DomUtil. $ ( button ) ;" 

+" UCF_DomUtil. attachEvent(btn,' click , function( )| alert( Hello World ); | );"); 
// WME style 


wdContext. currentContextElement( ). setStyle( " background ~ color; red "); 


5) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-280 所 示 。 


Hello World| 4— 


来 自 网 页 的 消息 Ge 


图 4-280 ”运行 效果 


4.4.5 ”路 线 图 


路 线 图 (RoadMap) 将 若干 步骤 显示 在 一 个 顺序 的 序列 中 ， 如 可 以 在 向 导 中 进行 具体 步 
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又 的 提醒 ， 并 能 够 根据 不 同 需求 设置 样式 。 路 线 图 包含 了 两 种 子 元 素 : “RoadMapStep” 2% 
IRMI “MultipleRoadMapStep” 多 级 步 又， 在 有 固定 步 数 的 路 线 图 中 可 直接 使 用 前 者 ， 而 在 动 
态 的 路 线 图 (不 确定 步 数 ) 中 则 可 使 用 后 者 。 两 种 子 元 素 也 可 以 混合 使 用 ， 非 常 灵 活 。 路 
线 图 元 素 包含 下 列 属性 。 

1) accessibilityDescription; 设置 复 选 框 组 中 的 文本 是 否 在 用 户 选中 整个 元 素 时 显示 。 

2) contextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默 认 有 “继承 ”“ 人 允许 ”和 “禁止 ” 
3 种 类 型 。 

3) contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 

4) enabled, 控制 元 素 是 否 可 用 。 

5) endPointDesign: 控制 路 线 图 终点 的 设计 样式 ， 默 认 有 以 下 5 种 样式 。 

e disabled; 选中 路 线 图 终点 时 不 会 触发 任何 事件 ， 且 显示 为 未 激活 状态 。 

e more; 路 线 图 终点 表示 还 有 更 多 的 后 续 步 又 未 显示 。 

e moreDisabled: 路 线 图 终 ， me oie 但 是 终点 的 样式 是 未 激活 状态 。 

e selected: 路 线 图 终点 可 以 被 选中 ， 还 能 额外 显示 一 些 文本 信息 。 

e standard: 默认 标准 的 路 线 图 终点 的 样式 。 

6) selectedStep; 控制 默认 选中 的 步骤， 若 使 用 多 步骤 路 线 图 ， 则 必须 与 相应 的 上 下 文 
结 点 进行 绑 定 。 

7) startPointDesign: 控制 路 线 图 起 点 的 设计 样式 ， 与 终点 样式 类 似 ， 默 认 有 以 下 5 种 
样式 。 

e disabled: 选中 路 线 图 起 点 时 不 会 触发 任何 事件 ， 且 显示 为 未 激活 状态 。 

e more; 路 线 图 起 点 表示 当前 显示 的 流程 之 前 还 有 更 多 的 步骤 未 显示 。 

e moreDisabled: 路 线 图 起 pie LAI SB ， 但 是 显示 样式 是 未 激活 状态 。 

e selected: 路 线 图 起 点 可 以 被 选中 ， 还 能 额外 显示 一 些 文本 信息 。 

e standard; 默认 标准 的 路 线 图 起 点 的 样式 。 

8) tooltip; 控制 提示 消息 的 显示 文本 。 

9) visible: 控制 元 素 是 否 可 见 。 

10) onLoadSteps 事件 : 当 路 线 图 还 有 更 多 步骤 未 显示 时 ， 用 户 在 单 击 更 多 步骤 时 进行 
的 初始 化 事件 ， 可 以 通过 映射 判断 是 否 已 到 达 路 线 图 的 末尾 。 

11) onSelect 事件 : 会 在 用 户 单 击 任 一 步 又 时 触发 ， 可 以 通过 映射 返回 当前 选中 步骤 的 
唯一 标识 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 )， 右 击 
“Outline” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 搬 和 信子 对 象 ， 选 择 “RoadMap “路线 
图 类 型 ， 输 入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-281 所 示 。 

2) 接着 插入 路 线 图 中 的 步骤 ， 右 击 “Outline” 中 新 建 的 路 线 图 ， 选 择 “ Insert Step”, 
随后 选择 “MultipleRoadMapStep” 多 级 步 又， 如 网 4-282 所 示 。 

3) 完成 创建 后 ， 保 存 所 有 修改 ， 如 图 4-283 所 示 。 

4) 创建 一 个 上 下 文 结 点 以 及 字符 串 类 型 的 特性 ， 分 别 用 于 对 应 路 线 图 的 数据 源 和 存放 
步骤 的 文本 ， 如 图 4-284 所 示 。 
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Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
| 
Category Library UI Element 

[All] [All] | |paaRoadMap 
Action Active Components = RowRepeater 
Complex Adobe C] ScrollContainer 
Graphic Analytics E] SectionHeader 
Integration Business Graphics K Shuttle 
Layout Business Intelligence | Splitter 
Menu Calendar [Table 
Selection Mobile Add-Ons F TabStrip 
Text Office Integration E] TextEdit 
Toolbar Pattern Development < E m 

ID RoadMap 


图 4-281 选择 元 素 类 型 


New UI Element FN LN 


Create a new Ul element 


Select the UI element you want to create. 


#9 MultipleRoadMapStep 
ao RoadMapStep | 


4 [Q roadMap| 
® desc 
图 4-284 上 下 文清 单 
n” 或 


4 baa RoadMap 
ooo MultipleRoadMapsStep | 


选择 元 素 类 型 4-283 ”元 素 清单 


5) 由 于 实例 中 进行 测试 的 是 多 级 步骤 ， 所 以 结 点 的 集合 属性 必须 是 “0 
“1 .. n”， 如 图 4-285 所 示 。 
6) 随后 选中 “MultipleRoadMapStep”， 修 改 其 属性 。 将 “dataSource” 


x] 4-282 


选择 刚 创 建 的 


“roadMap” 结 点 ,将 “description” 与 “dese” 特 性 进行 绑 定 。 注 意 不 要 混淆 其 中 的 两 个 属 
性 ,“description” 属性 是 为 每 一 步骤 显示 的 描述 ， 而 “name” 则 是 为 每 一 步骤 显示 的 名 称 ， 


里 只 绑 定 描述 属性 ， 如 图 4-286 所 示 。 


Misc 
Collection Cardinality 
Initialize Lead Selection 


0..n} oe 


true 


LI roadMap 
B roadMap.desc 


dataSource 


description 


图 4-285 ”修改 结 点 属性 图 4-286 修改 属性 


7) 在 开发 工具 中 ， 可 以 看 到 整个 路 线 图 的 雏形 预览 ， 如 图 4-287 所 示 。 

8) 随后 选择 “RoadMap” 路 线 图 ， 修 改 其 属性 。 将 “selectedStep” 选 中 步骤 修改 为 
“MultipleRoadMapStep”。 保 存 修改 后 ， 路 线 图 中 就 会 有 默认 选中 并 且 高 亮 显示 的 步骤， 如 
图 4-288 所 示 。 


= 


@desc 


+4 


@desc @desc 


I> 


BS 
个 
is 
Oo 
Oo 


图 4-287 TAX 
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9) 为 路 线 图 创建 一 个 “Select” 动 作 并 与 “onSelect” 事 件 绑 定 ， 如 图 4-289 所 示 。 


a Events 


onLoadSteps 
onSelect Select 


K| 4-289 ”修改 事件 属性 


10) 在 创建 动作 时 ， 新 建 “id” 和 “ele” 两 个 参数 ， 用 于 存放 对 应 步骤 的 唯一 标识 和 
ERIE, UE 4-290 所 示 。 


Details | Parameters | 


com.sap.tc.webdynpro.progmodel.api.IWDNodeElement 


图 4-290 添加 参数 


11) 右 击 “Outline” 清 单 中 的 路 线 图 |4 Roadmap Actions 
元 素 ， 选 择 “ Ln ape 创建 参数 : erst ees > 
wa 《如果 在 创建 动作 时 不 添加 对 应 参数 ，| 。 上 二 一 一 一 “一 
则 无 法 进行 映射 ) ， 将 路 线 图 所 选 的 关 步 又 
ID 与 创建 的 动作 中 的 参数 “id” 进行 映射 ， 图 4-291 进行 参数 映射 


将 所 选 对 象 与 参数 “ele” 进 行 映 射 ， 随 后 
单 击 “OK” 按 钮 ， 如 图 4-291 所 示 。 
12) 保存 所 有 修改 后 进入 Java 编辑 器 ， 添 加 事件 处 理 器 的 逻辑 ， 打 印 当前 选中 步骤 的 标识 : 


wdComponentAPI. getMessageManager( ). reportSuccess( " Selected Step:" +id) ; 
wdContext. nodeRoadMap( ). setLeadSelection( ele. index( ) ) ; // 设 置 为 选中 步骤 


13) 在 “wdDoInit” 方 法 中 添加 初始 化 路 线 图 的 代码 . 


TRoadMapNode nodeRoadMap = wdContext. nodeRoadMap( ) ; 

IRoadMapElement createAndAddRoadMapElement = nodeRoadMap. createAndAddRoadMapElement 
Or 

createAndAddRoadMapElement. setDesc(" 步 又 一 " ) ; 

createAndAddRoadMapElement = nodeRoadMap. createAndAddRoadMapElement( ) ; 
createAndAddRoadMapElement. setDesc(" 474% —" ) ; 

createAndAddRoadMapElement = nodeRoadMap. createAndAddRoadMapElement( ) ; 
createAndAddRoadMapElement. setDesc(" 步骤 三 " ) ; 


14) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 
可 进行 相关 测试 ， 如 图 4-292 所 示 。 

15) 单 击 任意 步 又， 如 图 4-293 所 示 。 

16) 在 消息 区 域 中 即 可 提示 对 应 选中 的 步 又 标识 ， 图 4-292 ”运行 效果 1 
如 图 4-294 所 示 。 


P] Selected Step:MultipleRoadMapStep 
图 4-293 ”运行 效果 2 图 4-294 选择 后 的 效果 
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4.4.6 阶段 指示 器 


阶段 指示 器 (Phaselndicator) 与 路 线 图 元 素 类 似 ， 也 是 将 若干 步骤 显示 在 一 个 顺序 的 序列 
中 ， 只 是 每 一 个 步骤 在 这 里 被 蔡 换 成 了 一 个 阶段 (phase)， 它 的 子 元 素 也 有 “Phase” 阶段 和 
“MultiplePhase” 多 级 阶段 两 种 类 型 。 不 同 于 路 线 图 元 素 的 是 ， 每 个 阶段 可 以 有 状态 图 标的 提醒 
(完成 、 警 告 以 及 不 可 用 ) ， 而 且 阶 段 指示 器 更 多 地 用 于 显示 更 “大 ”的 步 又。 一 般 来 说 ， 完 成 一 
个 阶段 会 比 完 成 一 个 步骤 花费 更 多 的 时 间 ， 这 是 阶段 指示 需 的 定位 。 它 包含 了 下 列 属性 。 

e accessibilityDescription: 设置 消息 提示 和 描述 等 文本 是 否 在 用 户 选 中 整个 选项 卡 集 时 显示 。 

è backgroundDesign: 控制 阶段 指示 器 的 背景 样式 ， 默 认 有 “emphasized” 和 “transpar- 

nt” 两 种 样式 。 

e contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 

e controlMenuDisabling: 控制 菜单 是 否 可 用 。 

e enabled: 控制 元 素 是 否 可 用 。 

e firstVisiblePhase: 用 于 指定 可 见 的 第 一 阶段 。 

e selectedPhase: 控制 锅 当 前 选中 阶段 的 唯一 标识 。 

e tooltip: 控制 提示 消息 的 显示 文本 。 

e visible; 控制 元 素 是 否 可 见 。 

e onSelect 事件 : 选择 事件 ， 在 用 户 单 击 任 一 阶段 时 触发 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步 又 ) ， 右 击 “Our- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 , RE ， 选 择 “PhaseIndicator” 阶段 
指示 器 类 型 ， 输 入 ID 名 称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-295 所 示 。 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[All] 全 | | fall 全 | |/poaPhaselndicator = 
Action Active Components = ProgressIndicator 
Complex Adobe ® RadioButton 
Graphic Analytics =|| | $1: RadioButtonGroupBylIndex 

i Integration 三 Business Graphics i SẸ RadioButtonGroupByKey 

Layout Business Intelligence (@) RFIDReader g 
Menu Calendar baa RoadMap 
Selection Mobile Add-Ons = RowRepeater 
Text | | Office Integration C] ScrollContainer + 
Toolbar Y| | Pattern Development ™ | [alll » 


ID Phaselndicator 


网 4-295 选择 元 素 类 型 
2) 随后 在 阶段 指示 器 中 添加 子 元 素 ， 如 图 4-296 所 示 。 RootElement 
3) 接着 搬入 阶段 指示 器 图 中 的 步骤 ， 右 击 “Outline” 中 新 建 pen Pheselndicator 


的 路 线 图 ， W “Insert Phase”， 随 后 选择 “MultiplePhase” 多 级 4-296 元素 清单 
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阶段 ， 如 图 4-297 所 示 。 

4) 完成 创建 后 ， 保 存 所 有 修改 ， 如 图 4-298 所 示 。 

5) 创建 一 个 上 下 文 结 点 以 及 字符 串 类 型 的 特性 ， 分 别 用 于 对 应 阶段 指示 器 的 数据 源 和 
存放 阶段 的 描述 ， 如 图 4-299 所 示 。 


Create a new Ul element 


Select the UI element you want to create. 


4 poa Phaselndicator S Canbala 
"te MultiplePhase g 
图 4-297 ”选择 元 素 类 型 图 4-298 添加 后 的 效果 图 4-299 上 下 文清 单 


6) 由 于 本 实例 中 进行 测试 的 是 多 级 阶段 ， 所 以 结 点 的 集合 属性 必须 是 “0 .. n” 或 
“1 .…n”， 如 图 4-300 所 示 。 

7) 随后 选中 “MultiplePhase” 多 级 阶段 (不 是 阶段 指示 需 ) ， 修 改 其 属性 。 将 “data- 
Source” 选择 刚 创 建 的 “phaseIndicator” 结 点 ， 将 “description” 与 “desc” 特 性 进行 绑 定 。 
注意 ， 不 要 混 消 其 中 的 两 个 属性 , “description” 属性 是 为 每 一 步骤 显示 的 描述 ， 而 “name” 
则 是 为 每 一 步骤 显示 的 名 称 ， 这 里 只 绑 定 描述 属性 ， 如 图 4-301 所 示 。 


Misc 


Collection Cardinality 0..n} T dataSource LJ phaselndicator 
Initialize Lead Selection true Kee or | 
14-300 结 点 属性 14-301 ”修改 属性 
8) 随后 选择 “PhaseIndicator” 阶段 指示 器 ， 修 改 其 属 [selecedPhase MuttiplePhase |] 
性 。 将 “selectedPhase” 选 中 阶段 修改 为 “MultiplePhase”。 图 4-302 ”修改 属性 


保存 修改 后 ， 阶 段 指示 器 中 就 会 有 默认 选中 并 且 高 亮 显示 
的 阶段 ， 如 图 4-302 所 示 。 
9) 在 “wdDolnit” 方 法 中 添加 初始 化 路 线 图 的 代码 . 


[PhaseIndicatorNode nodePhaseIndicator = wdContext. nodePhaseIndicator( ) ; 

[PhaselndicatorElement createAndAddPhaselndicatorElement = nodePhaselndica- 
tor. createAndAddPhaselndicatorElement( ) ; 

createAndAddPhaselndicatorElement. setDesc(" 步 又 一 " ) ; 

createAndAddPhaseIndicatorElement = nodePhaseIndicator. createAndAddPhaseIndicatorElement( ) ; 
createAndAddPhaselndicatorElement. setDesc(" 步 又 二 " ) ; 

createAndAddPhaseIndicatorElement = nodePhaseIndicator. createAndAddPhaseIndicatorElement( ) ; 
createAndAddPhaselndicatorElement. setDesc(" 步 又 三 " ) ; 


10) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测 | WA 
试 ， 如 图 4-303 所 示 。 


4.4.7 ”进度 指示 器 


进度 指示 器 (ProgressIndicator) 通过 一 个 横向 的 进度 条 来 显示 一 个 动作 的 实际 完成 比 


4-303 ”运行 效果 
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例 。 进 度 指示 器 可 以 用 来 标识 一 个 问卷 调查 的 提交 比例 ， 也 可 以 用 来 标识 一 个 长 期 项 目的 实 
际 开 发 进度 。 它 包含 了 下 列 属 性 。 

1) barColor: 控制 进度 指示 器 的 填充 颜色 。 
DERE ABR UD ARS 
进度 条 默认 显示 为 红色 。 

e neutral: 进度 条 默认 显示 为 蓝 色 。 

e positive; 进度 条 默认 显示 为 绿色 。 

E: 以 上 颜色 都 是 在 默认 主题 下 的 颜色 ， 实 际 项 目 中 颜色 也 会 根据 不 同 的 SAP 门户 主 
题 发 生变 化 。 

2) contextMenuBehaviour: 设置 上 下 文 菜单 行为 ， 默认 有 “继承 ” 
3 种 类 型 。 

3) contextMenuld; 设置 上 下 文 菜单 的 唯一 标识 。 

4) displayValue: 控制 进度 指示 器 上 显示 的 文本 ， 默 认 会 显示 进度 条 的 百分比 数字 。 

5) enabled; 控制 元 素 是 否 可 用 。 

6) percentValue: 控制 进度 指示 器 的 百分比 数值 。 

7) showValue: 控制 是 否 显 示 “displayValue” 属性 中 设置 的 文本 。 

8) tooltip: 控制 提示 消息 的 显示 文本 。 

9) visible: 控制 元 素 是 否 可 见 。 

10) width: 控制 元 素 的 显示 宽度 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 ) ， 右 击 “Our- 
line” 元 素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 “ProgressIndicator” 进 
度 指示 器 类 型 ， 输 入 ID 名称 ， 随 后 单 击 “OK” 按 钮 ， 如 图 4-304 所 示 。 


New UI Element cog 


® critical; 


® negative; 


“人 允许” 和“ 禁止” 
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Create a new Ul element 
Select the UI element you want to create. You can also enter an ID for it 
Category Library UI Element 
[All] [All] 全 = ProgressIndicator 
Action Active Components @ RadioButton 
Complex Adobe $i: RadioButtonGroupBylnde 
Graphic Analytics SP RadioButtonGroupByKey 
| Integration Business Graphics =|| | @)RFIDReader 
Layout Business Intelligence baa RoadMap 
Menu Calendar E RowRepeater 
Selection Mobile Add-Ons ScrollContainer 
Text Office Integration C] SectionHeader 
Toolbar Pattern Development ® Shuttle 
Danliinn T VEEE E bal a 到 | 
ID ProgressIndicator 
图 4-304 ”选择 元 素 类 型 


2) 随后 创建 视图 的 上 下 文 ， 右 击 “Context” 上 下 文 ， 在 弹出 的 对 话 框 中 输入 特性 名 称 
并 选择 对 应 类 型 ， 这 里 输入 “percentValue” 并 选择 整数 型 ， 如 图 4-305 所 示 。 


(a 7 
ER 二 ee 


| Create a context attribute =) 


. ; a 
Specify whether you want to create the element manually or with a 
context mapping, 


Create With 
© Mapping 
Model Binding 
Structure Binding 
@ Manually 


Name: percentValue 


Type: |integer >| | Browse... j 


F] Calculated 


i | 
O Co |=) E ee | 


K 4-305 输入 特性 信息 


3) 单 击 “Finish” 按钮 ， 完 成 上 下 文 特性 的 创建 ， 如 图 4-306 所 示 。 
4) 选择 视图 “Outline” 中 的 进度 控制 器 ， 将 它 的 百分比 属性 与 上 下 文 特性 进行 绑 定 ， 
如 图 4-307 所 示 。 注 意 ， 如 果 特 性 不 是 整数 型 ， 则 将 无 法 绑 定 。 


一 ProgressIndicator 
General property | Value 
= 4 Properties [ProgressIndicator] . 

一 一 一 一 一 一 id ProgressIndicator 
barColor neutral* 
contextMenuBehaviour inherit* 
contextMenuld 
displayValue 
enabled true 

4 Context 
O 人 Value) | percentValue B percentValue 
(B. percentvawue) showValue true 
4-306 上 下 文清 单 图 4-307 修改 属性 


5) 随后 在 进度 指示 器 前 面 添加 一 个 按钮 ， 并 创建 默认 动作 ， 用 于 模拟 进度 变化 。 进 入 
Java 编辑 器 ， 在 动作 的 事件 处 理 方法 中 添加 下 列 代 码 : 


// 使 用 上 下 文 根 结 点 的 当前 实例 ,并 获取 特性 值 
IContextElement currentEle = wdContext. currentContextElement( ) ; 
int percentValue = currentEle. getPercentValue( ) ; 
// 38 LE EE AEE FA WMT, VEREIS BE NCH IT 
if( percentValue == 100) | 

currentEle. setPercentValue(0) ; 
} else} 
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currentEle. setPercentValue( percentValue + 10) ; 


| 


6) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 就 可 以 进行 测试 了 ， 如 图 4-308 所 示 。 
7) 单 击 “运行 ”按钮 ， 就 能 看 到 进度 条 与 数值 的 变化 ， 如 图 4-309 所 示 。 


ED 


图 4-308 ”运行 效果 图 4-309 单 击 “运行 ”按钮 的 效果 


4.4.8 菜单 路 径 


菜单 路 径 (BreadCrumb) 常用 于 页 面 浏览 历史 。 

菜单 路 径 包 含 以 下 属性 。 

behaviour: 链接 方式 ， 包 售 multipleLinks 和 singleLink 选项 。 
enabled; 控制 元 素 是 否 可 用 。 

è separatorImageSource: 图 片 分 隔 符 。 

e separatorText: 文本 分 隔 符 。 

visible; 控制 元 素 是 否 可 见 。 

onSelect 事件 : 用 户 选择 某 一 页 签 时 触发 。 

开发 实例 : 

1) 打开 任 一 视图 (如 果 需 要 创建 新 的 工程 或 视图 ， 请 参考 之 前 章节 步骤 ) ， 右 击 
“Outline” 元素 清单 中 的 “RootElement” 根 结 点 ， 选 择 插入 子 对 象 ， 选 择 关 键 字 下 拉 列 表 类 
型 ， 输 入 ID 名称， 随后 单 击 “OK” 按 钮 ， 如 图 4-310 所 示 。 

2) 接着 插入 菜单 路 径 中 的 步骤， 右 击 “Outline” 中 新 建 的 菜单 路 径 ， 选 择 “ Insert 
Step”， 随 后 选择 “MultipleBreadCrumbStep” 多 级 步骤 ， 如 图 4-311 所 示 。 


a | | RootElement 4 “32 BreadCrumb 
4°32 BreadCrumb [=> MultipleBreadCrumbStep | 
图 4-310 元 素 清单 图 4-311 元 素 清单 


3) 建立 上 下 文 结 点 和 特性 ， 如 图 4-312 所 示 。 
4) 绑 定 上 下 文 结 点 至 元 素 的 数据 源 ， 如 图 4-313 所 示 。 


4) data 4 Properties[MultipleBreadCrumbStep] 
B link id MultipleBreadCrumbStep 
B text dataSource D data 
text B data.text 


图 4-312 上 下 文清 单 图 4-313 ”修改 属性 
5) 编写 初始 化 代码 : 


IDataNode nodeData = wdContext. nodeData( ) ; 

IDataElement createAndAddDataElement = nodeData. createAndAddDataElement( ) ; 
createAndAddDataElement. setText(" 导航 一 " ) ; 

createAndAddDataElement. setLink( "urll" ) ; 
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createAndAddDataElement = nodeData. createAndAddDataElement( ) ; 
createAndAddDataElement. setText(" 导航 二 " ) ; 
createAndAddDataElement. setLink( "url2" ) ; 
createAndAddDataElement = nodeData. createAndAddDataElement( ) ; 
createAndAddDataElement. setText(" 导航 三 " ) ; 
createAndAddDataElement. setLink( "url3" ) ; 


6) 保存 所 有 修改 ， 并 重新 编译 、 运 行 之 后 ， 即 可 进行 相关 测试 ， 如 图 4-314 所 示 。 
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第 5 董 ”综合 场景 应 用 


本 章 将 根据 SAP 实施 项 目 中 的 综合 场景 构造 一 个 复杂 应 用 ， 并 模拟 实际 项 目 中 构建 应 
用 的 步 又 ， 帮 助 大 家 进一步 地 了 解 Web Dynpro 开发 。 


5.1 前 期 准备 


在 一 个 大 型 的 实施 项 目 中 ， 前 期 准备 十 分 重要 ， 经 验 丰富 的 开发 顾问 也 会 参与 其 中 的 部 
分 工作 。 


5.1.1 用 户 需求 分 析 


虽然 在 一 个 SAP 咨询 项 目 中 ， 需 求 梳 理 和 确认 主要 由 业务 顾问 与 客户 沟通 来 完成 ， 但 
在 确认 之 前 还 是 需要 开发 顾问 参与 ， 因 为 开发 人 员 可 以 对 需求 的 技术 可 行 性 进行 确认 ， 也 可 
以 对 某 些 复杂 的 场景 设计 进行 必要 的 优化 。 这 不 仅 有 利于 项 目 实施 阶段 顺利 开展 ， 也 会 帮助 
用 户 在 上 线 后 更 快速 地 将 程序 应 用 到 实际 工作 当中 去 。 

在 完成 需求 确认 后 ， 项 目 组 成 员 需 要 对 确认 的 需求 进行 分 析 ， 梳 理 业 务 逻 辑 、 关 联 业务 
表 和 涉及 的 接口 服务 ， 最 终 形成 需求 规格 说 明 书 或 功能 设计 说 明 书 〈 根 据 实 际 项 目 安排 决 
定 ) ， 随 后 开发 顾问 就 可 以 根据 确认 的 需求 进行 实际 的 开发 工作 了 。 

本 章 开 发 实例 的 模拟 场景 为 “采购 申请 查询 ”: 用 户 根据 若干 查询 条 件 搜索 符合 条 件 的 
采购 申请 ， 随 后 单 击 行 项 目 也 可 查看 采购 申请 行 项 目的 明细 。 


5.1.2 接口 服务 设计 


接口 服务 的 方式 有 多 种 ， 在 之 前 模型 的 章节 中 介绍 过 RFC, EJB 以 及 Web 服务 等 类 型 ， 
当然 对 于 某 些 外 部 数据 源 也 可 以 直接 访问 数据 库 层 DAO 类 并 调用 对 应 方法 。 不 论 使 用 哪 种 
方式 ，Web Dynpro 中 的 模型 最 终 都 以 接口 的 形式 将 各 种 接口 服务 转化 为 了 WD4J 可 以 识别 
的 Java 类 。 

本 章 将 以 Web 服务 (Web Service) 作为 接口 ， 模 拟 Web Dynpro 程序 与 后 台数 据 的 交 

包含 采购 申请 查询 以 及 采购 申请 行 项 目的 明细 查询 。 

开发 实例 : 

1) 首先 创建 一 个 测试 用 的 Web 服务 , 在 NWDS 中 [= 33 Developme.. | #L Web Dynpro 39 Jav: 
单 击 右上 角 的 透视 图 切换 按钮 ， 切 换 到 “Development [ Development Infrastructure perspective 
Infratructure perspective”, WKI 5-1 所 示 。 

2) 右 击 自 定义 的 SC 目录 “MyComponents”， 选 择 
创建 一 个 “Development Component”, WKI 5-2 所 示 。 

3) 在 弹出 的 窗口 中 选择 对 应 的 EJB 类 型 Mi “Next” PRE, WEI 5-3 所 示 。 

4) 输入 自 定 义 DC 的 名 称 ， 单 击 “Next” 按 钮 ， 如 图 5-4 所 示 。 
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图 5-1 切换 到 DI 透视 图 


E E 


& 名 P 


New Development Component... 


Show In Development Configuration... 
Resync DCs... MyComponents 

Build Contained Local DCs 

Delete MyComponents 
Paste... demo.sap.com 

Import 

Export MyComponents 

View SC Description m 

Release 

Search for DC... 


Refresh 


图 5-2 创建 开发 组 件 的 菜单 选择 


局 New Development Component (Project) ee =| 


New Development Component 


Select Development Component Type. 


Type: 


4 WW sap.com 


E? Composite Application 
Content 
DC Build 
G Dictionary 
P Enterprise Portal 
á External Library 
© Java 
@ Java EE 


EJB Module 
(@) Enterprise Application 


Web Module 


图 5-3 选择 项 目 类 型 


m 


New Development Component 


Create New Development Component (Project) 


[7] Keep 


Vendor: |demo.sap.com 

Name: | man) myejb. pr 
Caption: 

Language: [American English 
Domain: Basis 

Support Component: [ 


(For Example BC-DWB-FOO) 


DC Local for Now (Use ‘Add to Source Control’ Later) 


图 5-4 输入 项 目 名 称 
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5) 选择 对 应 的 编译 版 本 ， 如 图 5-5 所 示 。 


Enterprise Bean Module Project 


Create a new EJB module project 


Project Name: | LocalDevelopment~aaa~demo.sap.com 


Java EE Version: 


Location 


@ Create project in the workspace 


Create project at external location 


Directory: | D:\Program Files\eclipse\workspace,jdi\LocalDevelopment\DCs\demo. | | Browse 


JPA Settings 


Use JPA 


JPA Version: |1.0 


5-5 选择 编译 版 本 


6) 创建 完成 后 ， 进 入 Java EE 透视 图 ， 并 右 击 EJB 工程 ， 选 择 创 建 一 个 “Session Bean”, 
如 图 5-6 所 示 。 


New >| Fy Project... 
Go Into D? DTD 
Open Type Hierarchy Fa | [xy XML 
Show In Alt+Shift+W > | [$f XML Schema 
E Copy coe | bt XE 
5 Copy Qualified Name @ Annotation 
È Paste Ctrl+V |G Class 
X Delete Delete |G@ Enum 
Remove from Context Ctrl+Alt+Shift+Down | @ Interface 
Build Path >| BY Package 
Source Alt+Shift+S > | §9 Source Folder 
Refactor Alt+Shift+T > E Message-Driven Bean (EJB 3.x) 
èg Import... R Session Bean (EJB 3.x) 
A 
Ea Export... Fi Example... 
% 
ul | Retress i Fs} Other... Ctrl+N 


图 5-6 选择 创建 SessionBean 菜单 


7) 按照 命名 规范 输入 自 定义 的 包 名 和 类 名 ， 单 击 “Finisn” 按 钮 ， 完 成 EJB 创建 ， 如 
图 5-7 所 示 。 

8) 创建 完毕 后 ， 可 以 看 到 开发 工具 自动 为 EJB 工程 生成 了 一 个 空 的 类 并 同时 实现 了 一 
个 接口 类 。 随 后 在 “PurReqWs” 类 中 添加 一 个 方法 ， 实 例 代码 如 图 5-8 所 示 。 
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Create EJB 3.x Session Bean 


Specify class file destination. E® 


EJB project: [LocalDevelopment~myejb. _pr~demo.sap.com "| 


: X 
Create EJB 3.x Session Bean g >» es gles) oe 


Source folder: \LocalDevelopment~myejb_pr~demo.sap.com\ejbModule | Browse. 


Java package: com.myproject 


Class name: PurReqWs| 


Superclass: [Browse.. 


State type: | Stateless "| 


Create business interface 


Remote |com.myproject.PurReqWsRemote | 


V] Local com.myproject.PurReqWsLocal 


@®@ < Back Next > Einish Cancel 


= = == = 


5-7 输入 信息 


| 


public PurReq getPurReqs( String purReqNo, String purReqType) | 
//TODO Auto - generated method stub 


return null; 


public class PurReqWs implements PurReqWsLocal { 
[xe 
* Default constructor. 
«/ 
public PurReqWs() { 
// TODO Auto-generated constructor stub 


} 


þublic PurReq getPurReqs (String purReqNo, String purReqType) í 
// TODO Auto-generated method stub 
return null; 


BS 


5-8 添加 代码 


9) 保存 后 在 接口 类 中 添加 获取 采购 申请 方法 的 声明 ( 见 图 5-9): 


public PurReq getPurReqs( String purReqNo, String purReqType) ; 


@Local 
public interface PurReqWsLocal { 
public PurReq getPurReqs (String purReqNo, String purReqType); 


} 


图 $-9 添加 代码 
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10) 由 于 还 未 定义 采购 申请 类 ， 因 此 暂时 会 有 编译 错误 。 下 面 需 要 根据 需求 (数据 库 


定义 ) 创建 采购 申请 和 
图 5-10 所 示 。 


采购 申请 条 


目的 对 象 类 。 


右 击 工程 ,选择 创 建 一 个 程序 包 ， 如 


图 5-10 


如 图 5-11 所 示 。 


New >| Fi Project... 
Go Into D DTD 
Open Type Hierarchy F4 | [xy XML 
Show In Alt+Shift+W > | [sy XML Schema 
B Copy Ctrl+C ial | XSE 
H Copy Qualified Name @ Annotation 
Ñ Paste Ctrl+V | G Class 
X Delete Delete |G Enum 
®% Remove from Context Ctrl+Alt+Shift+Down | @ Interface 
Build Path >| BY Package 


创建 包 的 菜单 选择 
11) 在 随后 弹出 的 对 话 框 中 输入 需要 创建 的 包 名 “com. bean” 


， 并 单 击 “Finish” 按钮 ， 


H 
New Java Package © 


Java Package 


Create a new Java package. 


Creates folders corresponding to packages. 


Source folder: LocalDevelopment~myejb_pr~demo.sap.com/ejbM 


Name: com.bean 


©) 


12) Adi 


“com. bean” 


BS 


5-11 


Finish Cancel 


输入 包 名 
包 ， 选 择 创建 一 个 类 ， 如 图 5-12 所 示 。 


New >| Fi Project... 
Go Into D? DTD 
Open Type Hierarchy F4 | [xy XML 
Show In Alt+Shift+W > | [5f XML Schema 
=) Copy Ctrl+C | ete 
H Copy Qualified Name @ Annotation 
Ñ Paste Ctrl+V |G Class 
里 Delete Delete | Œ Enum 
Remove from Context Ctrl+Alt+Shift+Down | @ Interface 
Build Path 上 | GY Package 


图 5-12 创建 类 的 菜单 选择 
13) 在 弹出 的 对 话 框 中 输入 需要 创建 的 类 名 “PurReq”， 


并 单 击 “Finish” 按 钮 ， 如 
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图 5-13 所 示 。 


Java Class 


Create a new Java class, 


Source folder: 


a 
EC 


LocalDevelopment~myejb_pr~demo.sap.com/ejbModu 


9 


Package: com.bean 
E| Enclosing type: 
Name: PurReq| 
i| Modifiers: @ public 
abstract [F] final 
Superclass: java.lang.Object 
Interfaces: 


© default private 


protected 


static 


Remove 


图 $-13 创建 类 


14) 创建 完成 后 ， 补 充 各 个 字段 定义 〈 暂 时 不 需要 添加 get 和 set 方法 ) : 


public class PurReq | 
private String reqNo; 
private String purType; 
private String remark; 
private String desc; 
private List < PurReqltem > items; 


| 


// 申 请 单 号 
// 申 请 类 型 
// 备 注 

// 描 述 

// 行 明细 


15) 定义 字段 后 ， 在 空白 处 右 击 ， 在 弹出 的 快捷 菜单 中 选择 “Source” 一 > “Generate 
Getters and Setters”， 自 动 创 建 字段 的 get 和 set 方法 ， 如 图 5-14 所 示 。 


器 


Quick Fix Ctrl+1 Toggle Comment 
Source Alt+Shift+S > Remove Block Comment 
Refactor Alt+Shift+T > Generate Element Comment 
Local History » 

Correct Indentation 
References Format 
Declarations 上 

Add Import 

[fa Add to Snippets... Organize Imports 

Aye > Sort Members... 
Debug As > Clean Up... 
Profile As å Override/Implement Methods... 
Validate Generate Getters and Setters... 
Team le Generate Delegate Methods... 


5-14 ”自动 生成 方法 


16) 在 弹出 的 对 话 框 中 选中 所 有 字段 ， 随 后 单 击 “OK” 按 钮 完成 创建 ， 如 图 5-15 


TAN o 
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17) 此 时 暂时 会 有 编译 错误 ， 因 为 还 
为 “PurReqltem”， 
定义 如 下 : 


Generate Getters and Setters 


并 补充 各 个 字 


Select getters and setters to create: 


yo desc 
Vo items 

V|] = purType 
W] © remark 
V| = reqNo 


i 


选择 对 应 变 直 


Al 5-15 


四 | 


没有 定义 行 项 


目的 对 象 类 。 再 创建 一 
段 定 义 ， 并 用 同样 的 方法 创建 对 应 的 get 和 set 方法 。 字 段 


个 类 ， 


命名 


| 


public class PurReqItem | 
private String reqNo; 
private String reqltemNo; 
private String account; 
private String itemType; 
private String matCode; 
private String price; 
private String count; 
private String reqDate ; 
private String unit; 
private String matGroup; 
private String werks ; 
private String lgort; 
private String shortDesc ; 
private String longDesc; 
private String charg; 


private String deliveryDate ; 


private String lifnr; 
private String ekorg; 
private String liwerks ; 


private String processStatus ; 


private String locks; 
private String creator; 


private String modifyDate ; 
private String reqPlanNo; 
private String adjustVendor; 


private String isImp ; 
private String currType; 
private String fileld; 


private String deliveryAddr; 
private String deliveryCity ; 


private String area; 


Ve 


1 请 单 号 


// 项 目 编号 


// 科 目 


// 项 目 类 别 


// 物 料 
// 单 价 
// 数 量 


// 需 求 日 期 


// 单 位 


// 物 料 组 


JF ILS 
// 库 存 


// 短 文本 
MENT 


// 批 次 


// 交 货 日 期 
Ve 


// 采 购 组 织 
// 供 应 工厂 


// 处 理 状态 


// 冻 结 标 识 


// 创 建 者 


// 修 改 日 期 
// HRT RS 


// 推 荐 供 


t 应 商 


// pee 
a 
// 技 术 文件 ID 


// 交 货 地 址 
// 交 货 城 市 


Bo 


18) 创建 完成 后 ， 保 存 所 有 修改 即 可 ， 如 图 5-16 所 示 。 


19) 下 面 基于 当前 EJB 创建 对 应 的 Web 服务 。 右 击 “PurReqWs” 
创建 一 个 Web 服务 ， 如 图 5-17 所 示 。 


“Web Services” 
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— “Create Web service” , 


K, TESA IP 


Th 


4 $Ë [LocalDevelopment] myejb_pr 
> (Gy Deployment Descriptor: [LocalD 
> Æ JAX-WS Web Services 
4 器 ejbModule 


4 出 com.bean Soper ET TT 
> WD PurReq java Replace With r Resource Path 
b [J] PurRegltemjava Restore from Local History... 


4 8 com.myproject Development Component » jms) 
> 国 PurReqWs,java >| |Ì Create Publication Information... 


> EE META-INF Properties Alt+Enter 


Ly 


5-17 创建 Web 服务 的 菜单 选择 


20) 在 弹出 的 对 话 框 中 ， 将 配置 级 别 的 滑 块 选择 “Develop Service”， 并 单 击 “Next” 
按钮 ， 之 后 的 步骤 均 使 用 默认 选项 直至 创建 完毕 ， 如 图 $-18 所 示 。 


5-16 创建 后 项 目 清 单 


Web Services 


Select a service implementation or definition and move the sliders to set the level of service and client generation. 


Web service type: [Boom up Java bean Web Service 


Service implementation: :ctPerinfoWs 


Client type: [ava Proxy 


图 5-18 配置 服务 级 别 


21) 再 次 进入 DI 透视 图 ， 创 建 一 个 EAR 工程 ， 用 于 依赖 EJB 工程 并 部 署 至 服务 器 端 。 
选择 新 建 类 型 为 “Enterprise Application”， 并 单 击 “Next” 按 钮 ， 如 图 $-19 所 示 。 


New Development Component (Project) = ae) 

New Development Component 

Select Development Component Type. 

Type: 

4 WW sap.com a 
加 Composite Application 

i > E Content 

| > DC Build 

| G Dictionary 

b Wr Enterprise Portal 

| á External Library 

E Java 

4 @ JavaEE 

EJB Module 


| Enterprise Application 


@ Web Module 


5-19 选择 项 目 类 型 
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22) 根据 实际 的 命名 规范 , 输入 自 定 义 ear BPR, FP GG “Next” $240, wn 
Al 5-20 所 示 。 


23) 根据 实际 需求 ， 选 择 对 应 的 Java EE 版 本 ， 并 单 击 “Next” 按 钮 ， 如 图 5-21 所 示 。 


J New Development Component (Project) [ele eS 
New Development Component 
A New Project mm © - Se Ses) 
Create New Development Component (Project) 
Enterprise Application Project eI 

Vendor: demo.sap.com - Create a new Enterprise Application project | 
Name: myear_py| 

Caption: Project Name: | LocalDevelopment~myear01~demo.sap.com 
Domain: | Basis "| Location 
Support Component: = Creat 

(For Example BC-DWB-FOO) Creat 
D:\n730_wk_nbk01,jdi\LocalDevelopment\DCs\demo.sap.com\myear01\_comp | | Browse 
Keep DC Local for Now (Use ‘Add to Source Control" Later) 


图 5-20 输入 项 目 名 称 图 $-21 选择 编译 版 本 


24) 选中 需要 进行 依赖 的 EJB 工程 ， 单 击 “Finish” 按 钮 ， 如 图 5-22 所 示 。 
25) 保存 所 有 修改 ， 完 成 两 个 工程 的 创建 ， 如 图 5-23 所 示 。 


New Project 


New EAR Project 


Description 


Referenced Projects: 


35 [LocalDevelopment] myear_pr 


$5 [LocalDevelopment] myejb_pr 


Al5-22 ”选择 依赖 工程 图 5-23 创建 后 项 目 目 录 


26) 接着 编译 并 部 署 EAR 工程 ， 将 创建 的 WebService 发 布 到 服务 器 。 右 击 “myear_pr” 
工程 ， 选 择 “Development Component” — “Build” 进行 编译 ,编译 完成 后 在 同一 菜单 中 选 
择 “Deploy” 进 行 部 署 ， 如 图 5-24 所 示 。 


Close Unrelated Projects 


Show In 上 
Validate Synchronize 
Compare Metadata 


— 
Run As k Deploy... 
Debug As r Update Project Settings 
Profile As » Enable Unit Test Support 
Team » 
compere With > Migrate to Software Component 


. Convert Project to Development Component... 

Restore from Local History... pe ab eT aa Pe 
Configure Label Decoration... 

Java EE Tools » 9 

Development Component 上 Log on 


5-24 部 署 的 菜单 选择 

27) 验证 Web 服务 是 否 部 署 成 功 。 用 管理 员 账 号 登录 服务 器 NWA 管理 者 平台 ,并 进入 
“Configuration - Connectivity” — “Single Service Administration”， 如 图 5-25 所 示 。 

28) 在 搜索 条 件 中 输入 “ * purreq * ”并 按 《〈Enter》〉 键 ， 搜 索 创 建 的 Web 服务 。 在 成 
功 搜 索 到 对 应 的 服务 后 ， 找 到 下 方 的 “WSDLs” 页 签 ， 并 单 击 “Test” 按 钮 进行 测试 ， 如 
图 5-26 所 示 。 

29) 单 击 “Text” 按 钮 会 弹出 一 个 新 窗口 ， 默 认 选 中 的 就 是 定义 的 接口 方法 ， 单 击 
“Next” 按 钮 ， 如 图 5-27 所 示 。 
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Destinations Views, 


Destination service for this purpose. 


Applications or services can establish connections to other services. When using 
connections of this type, you need to specify the remote service address and the 
user authentication information to use for the connection. Many applications use the 


My Workspace | Availability and Performance | Operations | Configuration | Troubleshooting | i SOA | 


Security | Infrastructure | Scenarios | ProcessesandTasks | Connectivity 


Java HTTP Provider Configuration ViewS 
Virtual Host can act as several different Web serve 
but referring only to a single real IP address. A user] 
different configuration settings for each of the virtu; 
created and configured. Logon load balancing incre] 
workgroups. To improve performance and ten) 


30) 在 下 一 步 中 填写 方法 的 输入 参数 ， 单 击 “Next” 


JCo RFC Provider 
@o The JCo RFC Provider Service processes ABAP to Java requests, and dispatches are distributed across available application servers 
Q E the calls to Java applications. Seen from an ABAP system, it provides an RFC workgroup services and load sensitivity. 
destination. Technically, the service is based on the JCo (SAP Java Connector). To ingle Service Administration Views, 
receive calls from ABAP, JCo servers are started and registered at the gateways | Siate Service Administration Y ti d 
of the ABAP systems. The configuration of these JCo servers is done here. a spea e a 
eb serv| Single Service Administration 
Value Help 
< Configure and manage the Value Help (F4 Help) alias settings. The configuration is 
>» primarily used to accelerate user input in custom developed user interfaces. 
£L TT 
图 5-25 NWA 平台 页 面 
yo Consumer Proxies | 
Search | Browse | 
| Find: |*purreg* Search by: | WSDL Port Type Name v State: | (All) bd 
Found Service Definitions: 1 Test scenario 
_ 一 FF nt z 一 
T | WSDL Port Type Name = | Namespace I> 1 2. 3 
P Service Operation Input Parameters 
门 PurReaWs httpv/myproject.com’ F 
区 Previous || Next >] || [Invocation Parameters | | | Invoke 
Service Information 
Operations 
Details about service definition "PurReqWs" 
Th Operation Name 
General Configuration Logs and Traces Classifications E 
ZIP Download m Rn 
oe 法 进 4 =] 
图 5-26 ”搜索 对 应 的 服务 图 5-27 ”选择 对 应 方法 进行 测试 


按钮 ， 如 图 5-28 所 示 。 


31) 得 到 了 服务 执行 成 功 的 消息 提醒 ， 暂 时 还 没有 返回 值 ， 如 图 5-29 所 示 。 


invoke | | 


4 Previous >] | Invocation Parameters | 
| Service Information 
Parameters 
| 
| Lamport [4]L Export] | 
- & getpurReqs: Aa 


D purReqNo: [V] Skip Ba 
L) purReqType: [X] Skip Bs 


Service test | Test scenario | 


Operation "getPurReqs” executed successfully in 0 sec 


Input Parameters 
XML Content 


| Export 

=" getPurReas: Ba 
口 purReqNo: (Null) 
L) purReqType: (Null) 


ll tal rs} e 
Service Operation Input Parameters Result 
4 Previous || Next »| | [Invocation Parameters | | [invoke | | [ Add to Test Scenario 
|_Service Information 


XML Content 


— ‘J getPurReqsResponse: Pa 
D retum: (Null) 


图 5-28 输入 对 应 参数 值 


32) 回 到 Web 服务 中 ， 修 改 之 前 的 “getPurReqs” 


例 代码 如 下 : 


图 5-29 ”查看 运行 


结果 


方法 ， 导 入 必要 的 类 文件 。 方 法 的 实 


req. setPurType( "01" ) ; 


public PurReq getPurReqs( String purReqNo, String purReqType) | 
PurReq req = new PurReq( ) ; 
req. setReqNo( "010000010000" ) ; 
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req. setRemark(" 采购 申请 备注 " ) ; 

req. setDesc(" 采 购 申 请 描述 " ) ; 

List < PurReqltem > reqltems = new ArrayList < PurReqltem > ( ) ; 
PurReqltem item = new PurReqltem( ) ; 
setAccount( " 1601030000" ) ; 
setAdjustVendor( " 10000000001" ) ; 
setArea( "CN" ); 

setCharg( "01" ); 

setCount("10") ; 

setCreator( "00001001" ) ; 

setCurrlype( "01" ) ; 
setDeliveryAddr(" 西 大 街 北 四 号 " ) ; 
setDeliveryCity(" 南京 " ) ; 
setDeliveryDate( "20161111" ) ; 
setEkorg( "0001" ) ; 

setFileld( "001" ) ; 

saili i" Ye 

setltemType( "01" ) ; 

setLgort( " Z001"); 

setLifnr( "0101000020" ) ; 

setLiwerks( "0001" ) ; 

item. setLocks( "0" ) ; 

item. setLongDesc ( " FE 4% \ \00000065069548 \ \ W JE 32 AE HY 
setMatCode( "000000000010000315" ) ; 
setMatGroup( " G001" ) ; 

setModifyDate( "20120908" ) ; 
setPrice( "2" ); 

setProcessStatus( " A01" ) ; 

setReqDate( "20120901" ) ; 
setReqltemNo( "10" ) ; 

setReqNo( "010000010000" ) ; 
setReqPlanNo(" P0005" ) ; 
setShortDesc ( " 电缆 \\00000065069548\\ 液 压 支 架 卓 
setUnit("EA" ) ; 

setWerks("SDOO" ) ; 

reqltems. add( item) ; 


item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 


item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 
item. 


item. 
item. 
item. 


req. setltems(reqlItems ) ; 
return req; 


| 


Hil I \ \DBT\ \ HE 


H"); 


He il EI\ \DBT\\ HELI" ); 


33) 再 次 编译 并 部 署 至 服务 器 ， 进 行 Web 服务 的 测试 ， 


即 可 得 到 硬 编 码 的 采购 申请 返回 值 ， 如 图 5-30 所 示 。 ' 


5.2 功能 开发 


根据 需求 分 析 可 以 明确 Web Dynpro 要 实现 表单 查询 以 
及 行 项 目 明 细 查 询 功能 ， 而 且 这 两 个 功能 都 涉及 与 接口 服务 
的 交互 。 


5.2.1 创建 WD4J 项目 


XML Content HTTP Log 


3 getPurReqsResponse: Pu 
J return: Za 
) desc: KIRE 
- I items (1: Pa 
- O tems: Zs 
O account: [1601030000 
adjustVendor: 10000000001 


area: (CN 


J a 

L charg: (01 Ba 

L count: 10 Aas 

LÌ creator: (00001001 Dy 

] currType: (01 Ba 
O) deiveryaddr [西天 街 北 四 号 Ba 
口 deiverycity: | 南京 Fa 
L) deliveryDate: (20161111 Pa 
) ek 0001 2. 


本 节 将 创建 一 个 Web Dynpro 工程 ， 用 于 对 Web 服务 的 
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图 5-30 iTA 


调用 。 

开发 实例 : 

1) 在 Web Dynpro 透视 图 中 ， 单 击 左 上 方 新 建 按 钮 旁边 的 箭头 ， 选 择 “Web Dynpro De- 
velopment Component”， 如 图 5-31 所 示 。 

2) 在 弹出 的 对 话 框 中 选择 “MyComponents”， 单 击 “Next” 按 钮 ， 如 图 5-32 Prax, 5 
外 ， 也 可 以 在 DI 透视 图 中 右 击 “MyComponents” 进行 创建 ， 再 选择 Web Dynpro 类 型 ， 结 
相同 。 


= 
New Development Component (Project) l = Lo! xn} 


Select Software Component 
Select the software component where you want to create the 


DC(s). The settings for the selected component will be 


4 & LocalDevelopment 


g MyComponents [demo.sap.com] | 


CE 98 中国 ® 0 | 

F: Web Dynpro Development Component 
| Fi Project... = 

[T3 Example... O) < Back Finish Cancel 

Ei Other... Ctrl+N \ J 
图 5-31 创建 开发 组 件 的 菜单 选择 图 5-32 ”选择 本 地 组 件 包 


3) 输入 工程 名 称 “mydynp04”， 单 击 “Finish” 按钮 ， 完 成 创建 ， 如 图 5-33 所 示 。 
4) 随后 展开 工程 的 日 录 ， 右 击 “Components” 组 件 ， 选 择 创建 一 个 组 件 ， 如 图 5-34 
所 示 。 


E New Development Component (Project) Sx") 
New Development Component 
Create New Development Component (Project) a 
Vendor: demo.sap.com 3 
Name: mydynp04 

中 Caption: 

|| Language: [American English X | 
Domain: | Basis X | 
Support Component: X 


(For Example BC-DWB-FOO) 


Keep DC Local for Now (Use ‘Add to Source Control’ Later) 


Preferences Create Component 


Paste Ctrl+V 


Apply Template 


Compare Metadata 


i > 


N Remove from Context Ctrl+Alt+Shift+Down 


Al 5-33 输入 项 目 名 称 图 5-34 创建 组 件 的 菜单 选择 


5) 输入 组 件 名 称 ， 并 勾 选 创建 默认 窗口 和 视图 ， 单 击 “Finish” 按 钮 ， 如 图 5-35 
所 示 。 
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6) 至 此 ， 完 成 了 一 个 Web Dynpro 工程 的 创建 ， 如 图 5-36 所 示 。 
[高 New Component -a ~ ney x 


Specify Component Properties 

Enter name and package for the new Web Dynpro Component 

Component Name Dynp04 01komp 

Component Package com.sap.demo.mydynp04.wd.comp.dynp04 01， 4 BE [LocalDevelopment] mydynp04 

4 yi Web Dynpro 
器 Applications 
Choose additional capabilities for the new component @ Models 
¥) Default Window and Views [aj] Component Interfaces 

Used Models 4 «i Components 


|| Implemented Interfaces 
EÈ Component Controller 


> Local Component Interface 
$ Custom Controllers 

i @ Implemented Interfaces 
国 Message Pool 
@y Used Models 
«i Used Components 

4B Views 

O) < Back | Next > | | Finish | | Cancel E Dynp04_01CompView 

> FE Windows 


5-35 输入 组 件 名 称 图 5-36 创建 后 的 项 目 结构 


BS 


5.2.2 核心 功能 开发 


本 节 将 调用 之 前 定义 的 Web 服务 ， 并 在 Web Dynpro 中 完成 处 理 。 

开发 实例 : ren 

1) 首先 创建 对 应 模型 ， 右 击 工 程 中 的 “Models”， 选 择 “ Create Creet Modd 
Model”， 如 图 5-37 所 示 。 5-37 ”创建 模型 

2) 在 弹出 的 窗口 中 选择 对 应 的 模型 类 型 ， 选 择 第 二 项 “Adap- 的 菜单 选择 
tive Web Service Model”， 并 单 击 “Next” 按 钮 ， 如 图 5-38 所 示 。 

3) 输入 自 定义 模型 名 称 “NewAWSI1Model”， 并 选中 “Remote Location/File System” 单 
选 按钮 作为 WSDL 描述 文件 的 源 文件 ， 单 击 “Next” 按 钮 ， 如 图 5-39 所 示 。 


"BE New Model nl — ill WH |S te Ee x 


BS 


= od ee a WS | See D| x . = 
New Model || Import an Adaptive Web Service Model oe 
|| Select a model type $ ĝ Web Dynpro model created for Web services &% 
d 7 
This wizard provides a guides for creating Web Dynpro models & 5. 


Model Name — NewAWS1Model 


Available Models: | Model Package com.sap.demo.mydynp04.wd.models.newaws1model 


® Adaptive RFC 2 Model This wizard guides you through creating 

2 Adaptive Web Service Model an Adaptive Web Service Model 

{§3 Enterprise JavaBean Model 

{$3 Java Bean Model Available WSDL Sources 


» Enterprise Service Repository 
a 


5 Services Registry 


器 


5-38 选择 模型 类 型 图 5-39 输入 模型 信息 
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4) 输入 之 前 创建 的 Web 服务 对 应 直人 生生 
DLS” 页 签 中 可 以 看 到 ) ， 粘 贴 的 同时 开发 工具 会 立即 对 服务 做 连通 性 测试 。 测 试 成 功 后 显 
示 下 一 步 ， 单 击 “Next” 按 钮 ， 如 图 5-40 所 示 。 

5) 接着 进行 运行 时 间 相 关 配 置 ， 选 中 “No service group configuration” 单 选 按 钮 ， 单 击 
“Next” 按 钮 ， 如 图 5-41 所 示 。 


New Mo = S| Service Interfaces: | Name | 
— 
PurReqWs 
|| WSDL URL Access q 
o> 
& 
URL: 105.79:50000/PurReqWsLocal/tiiee unt wsdl&mode=ws_policy Browse D Choose existing: 
Network Settings Preference Page 5 Create new 
Package: (default) Browse 
Name 127001 


© 
| 
时 
E 
q 
4 
im 
3 


人 @@ | < Back I Next > | | Finish | | Cancel Cancel 


图 5-40 输入 服务 地 址 图 5-41 ”选择 服务 组 


6) 输入 逻辑 目标 名 称 ， 使 用 默认 配置 ， 并 单 击 “Next” 按 钮 。 如 果 已 在 服务 器 端 配置 
完成 ， 则 可 以 使 用 所 配置 的 名 称 ， 也 可 以 使 用 同一 个 目的 ， 如 图 5-42 所 示 。 


New Model 


= ee = EE 


Logical Destinations ĝ 
Define logical destinations for metadata retrieval and execution of the WSDL & 十 


Define Logical Destinations 


© No logical destinations. Use WSDL URL for metadata retrieval and webservice execution. 


© Use destinations for metadata and execution. This allows you to configure the Web service provider sy 


Default Metadata Destination DEFAULT_WS_METADATA_DEST X 
Default Execution Destination SAZU AVS a X 


@ You can change the WSDL URL after import by changing the corresponding model setting value. This is 


图 5-42 输入 目的 名 称 


7) 根据 需要 对 导入 的 模型 类 进行 重 命 名 ， 跳 过 则 直接 单 击 “ Next” 按 钮 ， 如 
图 5-43 所 示 。 

8) 在 弹出 的 对 话 框 中 ， 可 以 看 到 导入 日 志 ， 也 就 是 看 到 对 应 Web 服务 接口 在 Web 
Dynpro 模型 中 生成 的 接口 结构 ， 单 击 “Finish” 按 钮 完成 模型 的 导入 配置 ， 如 
图 5-44 所 示 。 

9) 完成 配置 后 ， 就 可 以 在 工程 的 目录 中 看 到 对 应 导入 的 模型 以 及 模型 类 结构 ， 如 
图 5-45 所 示 。 
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ir . 
New Model aan z < 


Rename Model Classes 


You can rename the model classes by editing the "Modd 
The names must only consist of the characters a..z, A..Z, 


Show Renamed Model Cla: (Enabled only if model cl 


Actual Model Class Name 
>  http://myproject.com/ 
> 出 http://sap.com/tc/webdynpro/model/webse 


Prog 


F = 
New Model 


一 | 


Import Log 


Detailed description of the model import status 


出 

4 @ NewAWS1Model 
G+ GetPurReqs 
> Ê+ GetPurReqsResponse 
> G+ PurReq 

> @+ PurReqltem 

> G+ Request_GetPurReqs 

> @+ Response_GetPurReqs 


图 5-43 ”重合 名 导入 类 


图 5-44 查看 导入 日 志 


4 BE [LocalDevelopment] mydynp04 
a yA Web Dynpro 
T Applications 
4 @ Models 
4 | 43, NewAWS1Model 
4 @ Model Classes 
Ê GetPurRegs 
> Ê GetPurReqsResponse 
> Ê PurReq 
Ê PurReqltem 
> a Request_GetPurReqs 
> ê Response_GetPurReqs 


BS 


5-45 SAS IZR 


10) 在 导入 模型 完成 之 后 ， 需 要 创建 对 模型 接口 的 调用 ， 即 创建 自 定 义 控制 器 。 首 先 需 
要 添加 对 导入 模型 的 引用 : 右 击 组 件 中 的 “Used Models”， 选 择 “Add”， 如 图 5-46 所 示 。 

11) 在 弹出 的 对 话 框 中 选中 之 前 导入 的 “NewAWS1Model” 模 型 ， 并 单 击 “OK” 按 钮 ， 
如 图 5-47 所 示 。 

12) 添加 引用 之 后 ， 需 要 创建 一 个 自 定义 控制 器 
并 选择 “Apply Template”, WA] 5-48 所 示 。 


: 在 组 件 中 右 击 “Custom Controller” , 


TRY Se) 
Select models: 
团 NewAWS1Model 

| i $< Custom Controllers) č č 
I 3 Create Custom Controller 

@ Implemented Interfaces Deselect All |a = pase 

Message Pool Compare Metadata 

有 

'@y Used fra Development Component 

<A Used d Add |o Gee) Gee = 

》 三 Views Compare Metadata 一) [se +S Apply Template... 
图 5-46 添加 使 用 模型 图 5-47 ”选择 模型 图 5-48 ”选择 应 用 模板 的 菜单 选择 


13) 在 弹出 的 对 话 框 中 选择 第 一 项 “Service Controller”， 并 单 击 “ Next” 按 钮 ， 如 
图 5-49 所 示 。 

14) 选择 之 前 导入 的 “NewAWS1Model” 模 型 的 请 求 方法 ， 并 单 击 “Next” 按 钮 ， 如 
图 5-50 所 示 。 


| Select Template 


| Creates or configures a controller in the component The list of models is filtered. Supported model types are Adaptive 


RFC1, Adaptive RFC2, WebService, Adaptive WebService & 


Template Instance Name Service Controller Controller NewAWS1ModelController 


Available Templates: NewAWS1Model 


4 23 NewAWS1Model 
Ó Request_GetPurReqs | 


Creates or configures a controller in the 
component 


| |E Service Controller | 


GP Callable Object 


到 


5-50 选择 对 应 请 求 方法 


Finish 


Em 


BS 


5-49 选择 模板 类 型 


BS 
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15) 选中 所 有 的 结 点 作为 自 定 义 控 制 器 中 的 上 下 文 并 同时 完成 与 模型 的 映射 配置 ， 随 后 
单 击 “Next” 按 钮 ， 如 图 5-51 所 示 。 

16) 默认 可 以 同时 创建 模型 的 执行 方法 ， 即 触发 接口 调用 ， 输 入 方法 名 称 ， 随 后 单 击 
“Finish” 按钮 ， 如 图 5-52 所 示 。 


CE = 


f 
Model Binding 


I| Select the context elements you want to bind. Rename them by clicking the 
| corresponding item in the list on the right. 


4 EO Context Name Model Class or... Mc 
4 VA Request_GetPurRegs [items PurReqitem Itelz 
> BIG GetPurRegs Account Account E 
4 MA Response B AdjustVe... AdjustVendor 
4 圆 回 GetPurReqsResponse Area ris 
Reti 
-EE Return _ @Charg  Charg 
7| ©) Items 
@ Count Count 
¥) @ Desc 
BCreator Creator 
¥] @ PurType cunt ae 
V| B Remark B® CurrType urrlype = 
A Dalene Fe er 
V] @ ReqNo 4[ mn ] 上 


|| Specify Method for Model Execution 


[V] Resolve bindings according to context element name. Existing bindings will be replaced 
pl Automatically resolve name dashes || Enter the name for the method if the model has to be executed 


V] Generate method for model execution 


@ [<Back | Net> |[ Fnish |[ Cancel Method Name pxecuteGetpurReqs 


5-51 选择 上 下 文 结 点 


器 


5-52 输入 执行 方法 名 称 


17) 完成 后 保存 所 有 修改 ， 可 以 在 模型 编辑 器 中 看 到 映射 关系 已 创建 ， 如 图 5-53 
所 示 。 

18) 打开 组 件 控制 器 ， 并 定义 对 应 的 上 下 文 和 调用 方法 ， 右 击 上 下 文中 的 “Context” 结 
点 ， 选 择 新 建 结 点 ， 如 图 5-54 所 示 。 


<3 Component Controller 


General Edit\View: @ Context Properties © Context Mapping 


4 fj Dynp04_01Comp References 


Ag T E | Property 
@ Component Controller 


> Context 
加 oss O Con 
> [A] Local Component Interface NewAWS1 | @aNewAwsi Methods 1 New +| Node... 
4 $ Custom Controllers ModelCo.. Model aa 
be Event Handlers p| 日 Attribute... 
| 这 NewAWS1ModelControlle:— References 


ju 


@ Implemented Interfaces Events | Binding Chain 
[E] Message Pool 
4 @, Used Models | B Copy Ctrl+C 
4 NewAWS1Model | © Paste Ctrl+V 


Ly 


5-53 RIN A we SCPE Hill tie et HR 


PRY 
n 
l 
mn 
下 


创建 上 下 文 结 点 


19) 在 弹出 的 对 话 框 中 选中 “Mapping” 单 选 按钮 ， 单 击 “Nex” 按 钮 ， 如 
图 5-55 所 示 。 
20) 选择 创建 的 “NewAWS1ModelController” 自 定义 控制 器 ， 随 后 选择 对 应 的 结 点 ， 单 
击 “Next” 按 钮 ， 如 图 5-56 所 示 。 
21) 选中 相应 的 结 点 和 特性 后 ， 单 击 “Finish” 按 钮 ， 如 图 5-57 所 示 。 
22) 创建 上 下 文 完成 后 ， 保 存 所 有 修改 即 可 ， 如 图 5-58 所 示 。 
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Create a context node 


Select Context Element 


Specify whether you want to create the element manually or with context mapping, 


page as sia Select th intext el: it it te 
model binding or structure binding Ser gn ee fe E, 


Create With 
© Mapping 


NewAWS1ModelController - com.sap.demo.mydynp04.wd.comp.dynp04_01comp 


lodel Binding 
) Structure Binding 
© Manually 


a © Context 
4 回 Request _GetPurRegs| 
> [I GetPurRegs 
> DB) Response 


Name: 


Add Required Controller... 


[Finish 


Cancel Finish 


BS 


5-55 ”选择 结 点 类 型 图 5-56 


Select the context elements to map 


Rename elements by clicking the corresponding item in the list on the right 


© Context 
V| CQ) Request_GetPurReqs 


Name Mapped Element 


> 七 


v 


4 


C GetPurRegs 
[ Response 
V| CQ) GetPurReqsResponse 


aly 


b 


C Return 
E] 
V| B Desc 
V| BB Purlype 
加 g Remark 
加 g ReqNo 


(Items 

B Account 

B AdjustVendor 
B Area 

B Charg 

B Count 

B Creator 

B CurrType 

B DeliveryAddr 
B DeliveryCity 


R DelivervDate 


Items 
Account 
AdjustVendor 
Area 

Charg 

Count 
Creator 
CurrType 
DeliveryAddr 
DeliveryCity 


DelivervDate 


Resolve mappings according to context element name. Existing mappings will be replaced 


Automatically resolve name clashes 


5-57 选择 对 应 上 下 文 
23) 进入 自 定 义 方 法 的 页 签 ， 单 击 加 号 创建 一 个 自 定义 方法 ， 如 图 5-59 所 示 。 


<& Component Controller 
General 
References ra =; 
Sones filter text Add 
2 © Context ‘Methods = te 
4 E Request GetPurReqs Basa 
>  GetPurRegs 
> EQ) Response LIE 


图 5-58 上 下 文清 单 


5-59 ” 自 定 义 方法 页 签 


24) 输入 方法 的 名 称 ， 由 于 不 需要 配置 参数 ， 因 此 单 击 “Finish” 按 钮 即 可 ， 如 图 5-60 
所 示 。 
25) 保存 修改 后 ， 进 入 Java 编辑 器 ， 在 方法 中 添加 代码 ( 见 图 5-61): 
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wdThis. wdGetNewA WS] ModelControllerController( ). executeGetPurReqs( ) ; 


New Me 
Specify Method Properties 
Enter properties of Method 
Name getPurReqs| 
Return Type [void my | Browse... ] 
Array Type 
Dimension 
public void getPurReqs( ) { 
//@@begin getPurReaqs() 
wdThis .wdGetNewAWS1ModelControllerController() .bxecuteGetPurReqs () : 
® Back [Next> |[ Finish [| Cancel //@Gend 
} 


图 5-60 输入 方法 名 称 5-61 添加 代码 
注 : 对 于 简单 架构 的 程序 ， 可 以 跳 过 组 件 控 制 器 中 上 下 文 和 自 定义 方法 的 创建 ， 直 接 从 
视图 映射 到 自 定义 控制 器 即 可 ， 但 还 是 推荐 从 组 件 控制 器 进行 调用 ， 方 便 后 期 运 维 管理 。 
26) 进入 视图 ， 创 建 对 应 的 上 下 文 ， 右 击 上 下 文中 的 “Context” 结 点 ， 选 择 新 建 结 点 ， 
如 图 5-62 所 示 。 
27) 在 弹出 的 对 话 框 中 选择 “Mapping” 映 射 结 点 ， 随 后 单 击 “Next” 按 钮 ， 如 
图 5-63 所 示 。 


Create a context node 


Dynp04_01CompView Specify whether you want to create the element manu 
model binding or structure binding 
General Edit\View: @ Context Properties © Context Mapping Create With 
References Co & A E || Property @ Mapping 
© Model Bindin 

Context | : : 9 
Methods | | New r| Node... © Structure Binding 

| P © Manually 
Event Handlers J References | a Attribute... on 
Actions | = ii 

| Binding Chain 


图 5-62 创建 上 下 文 结 点 图 5-63 ”选择 结 点 类 型 


28) 选中 需要 进行 映射 的 控制 器 ， 并 单 击 “OK” 按 钮 ， 如 图 5-64 所 示 。 
29) 选中 相应 的 结 点 和 特性 后 ， 单 击 “Finish” 按钮 ， 如 图 5-65 所 示 。 


Select the context elements to map 


Rename elements by clicking the corresponding item in the list on the right 


4 DO Context Name Mapped Element 
4 A Request GetPurReqs 回 Hems Items 
> WIL GetpurReqs B Account Account 
+ WIL Response 可 Adjustvendor  AdjustVendor 
4 (ICQ GetPurReqsResponse T Area ror 
4 回回 Return B charg Charg 
UG tems B Count 
B Desc 
B PurType 


Count 
B Creator Creator 

B CurrType CurrType 

B DeliveryAddr DeliveryAddr 
B DeliveryCity DeliveryCity 
R Delivervpate Delivervpate 


B Remark 
B ReqNo 


i lers: 
Select required controllers: Resolve mappings according to context element name. Existing mappings will be replaced 


[V] Automatically resolve name clashes 


|g Dynp04_01Comp - com.sap.demo.mydynp0! 


T] Dynp04_01CompWindow - com.sap.demo.n| 
22 NewAWS1ModelController - com.sap.demo| 


@ 


图 5-64 选择 控制 器 图 5-65 选择 对 应 上 下 文 
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30) 接着 创建 视图 中 的 页 面 元 素 ， 右 击 “RootElement”， 在 弹出 的 快捷 菜单 中 选择 
“Apply Template”， 如 图 5-66 所 示 。 
31) 选择 “Form”， 随 后 单 击 “Next” 按 钮 ， 如 图 5-67 所 示 。 


BE Outline £3 @ Documentation View 
一 -一 一 一 一 — Select Template 
é 
[RootElement| Creates a form in the view 
Insert Child... 
Cut Ctrl+X Template Instance Name Forml 
Copy Ctrl+C Available Templates: 
Paste Ctrl+V n m 
Ej Action Button Creates a form in the view 
Replace With 上 E Form 
X Delete Delete E Table 

Move Up 
Move Down 


Parameter Mapping 
Translatable Texts 


Apply Template 


KI 5-66 ”应 用 模板 的 菜单 选择 图 5-67 选择 模板 类 型 


32) 选中 需要 创建 元 素 的 上 下 文 特性 ， 单 击 “Next” 按 钮 ， 如 图 5-68 所 示 。 
33) 确认 元 素 类 型 后 ,， 单 击 “ Finish” 按 钮 ， 完 成 查询 条 件 的 页 面 元 素 创建 ， 如 
图 5-68 所 示 。 


34) 接着 创建 一 个 查询 按钮 ， 右 击 透明 容器 ， 选 择 “Insert Child”, WE 5-70 所 示 。 
= ee) 


elect Attributes 


Select the attributes that the form elements will be bound to 


4 mO Context 
4 E Request GetpurReqs 
a VI GetPurRegs 
7) 可 PurReqNo 
7) B PurReqType 
> HA Response 


L C] RootElement 
a [ ] TransContainer 0 
© T PurReqNo_label 
Re PurReqNo 
T PurReqType_label 


@ [<Back | Next>) (Finish) [Cancel 


Fe PurReqType [L TransContainer_0 


& Context Menus Insert Child... 


Al5-68 选择 对 应 上 下 文 图 5-69 ”创建 后 的 元 图 5-70 ”插入 子 元 素 的 
素 清单 菜单 选择 


35) 选择 “Button” 按 钮 类 型 ， 单 击 “OK” 按 钮 ， 如 图 5$-71 所 示 。 

36) 完成 按钮 创建 后 ， 创 建 默 认 动 作 ， 切 换 到 事件 页 签 并 单 击 “Create” 按 钮 ， 如 
图 5-72 所 示 。 

37) 输入 动作 名 称 “Seach”， 单 击 “Finish” 按 钮 ， 如 图 5-73 所 示 。 

38) 保存 修改 后 ， 进 入 Java 编辑 器 ， 在 按钮 处 理 方法 中 添加 代码 ( 见 图 5-74) : 
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Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category 


Library 


UI Element 


[All] 

Action 
Complex 
Graphic 
Integration 
Layout 
Menu 


[All] 

Active Components 
Adobe 

Analytics 

Business Graphics 


Business Intelligence 


Calendar 


m Button 

本 ButtonChoice 

GB ButtonRow 

Eð CalendarDayView 
E CalendarMonthView 
国 CalendarPaginator 
E] CalendarWeekView 


Selection Mobile Add-Ons 4 m 


ID Button 


Documentation 


The Button UI element represents a push button. 


When the hittan is artivated event nnarrinn is trinnered This avant has nn narameters hiit 


= Button 
Bienen Property Value 
Events 
LayoutData — 
@ OK Cancel ep- | onAction ~ (Go |fGreate] 
vents 


图 5-71 选择 元 素 类 型 图 $-72 ”修改 事件 属性 


JE New acion 3 A 
Specify Action Properties 
I| Enter the properties for the new action 
Name Seach 
Text E g o a 
| Icon Browse... 
Validation 区 
|| Event Handler 
|| @ Use Default 
| onActionSeach 
I| © Use existing 
= >| | New 
[V] Adapt parameters to fit event handler parameters 
Fire Plug |<None> "| [New..| | 
| | 
| | 
©) <Back | Next> | [ Finish) [Cancel] 


图 5-73 输入 动作 名 称 


wdThis. wdGetDynp04_01CompController( ). getPurReqs( ) ; 


public void onActionSearch(com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 


begin onActionSearch (ServerEvent) 


wdThis.wdGetDynp04 01CompController() .getPurReqs () :| 


图 5-74 ”添加 代码 


39) 接着 再 次 应 用 模板 ,创建 采购 申请 抬头 字段 的 返回 数据 ， 右 击 “RootElement”,， 在 
弹出 的 快捷 菜单 中 选择 “Apply Template”， 如 图 5-75 所 示 。 
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40) 选择 “Form”， 单 击 “Next” 按 钮 ， 如 图 5-76 所 示 。 


Apply Tem 2 


Select Template 


Creates a form in the view 


RootElement| 


Insert Child Template Instance Name Form0 

Cut Ctrl+X Available Templates: 

copy SUR ay Action Button Creates a form in the view 
Paste Ctrl+V fromm | 

Replace With 上 Table 


Delete Delete 


Move Up 


Move Down 


Parameter Mapping 


Translatable Texts 人 @) | nai | Finish Cancel 


Apply Template 


图 $-75 应 用 模板 的 菜单 选择 图 5-76 选择 模板 


41) 选中 采购 申请 的 必要 信息 ， 单 击 “Next” 按 钮 ， 如 图 5-77 所 示 。 
42) 将 其 中 的 采购 申请 描述 和 采购 申请 备注 两 个 字段 ( 即 “Dese” 和 “Remark” 字 段 ) 
修改 为 “TextEdit” 视 图 元 素 类 型 ， 随 后 单 击 “Finish” 按钮 完成 表单 创建 ， 如 图 5-78 所 示 。 


Apply Tem = 
Select Attributes Specify Form View Properties 
Select the attributes that the form elements will be bound to i Edit the properties of the form elements and their labels 
E GetPurReqs 
a a ee Name Attribute Editor Bound Prop... [a 
B purReqType Desc Desc (Request_GetPur... ~ value N 
[ Response PurType PurType (Request_Get... InputField value 
EC GetPurReqsResponse Remark Remark (Request_Get... TextEdit value 
4 国 ReqNo ReqNo (Request_Get... InputField value 


B Purlype 
B Remark 
B ReqNo 


A default label text is set if there is no other type information available. 
In some special models, this could hide potential field label metadata at runtin 


V] Set default texts for all labels 


| [Finish |[ Cancel 四 sai Next > 


图 5-77 选择 对 应 结 点 图 5-78 调整 元 素 类 型 和 位 置 


43) 创建 完成 后 ， 保 存 所 有 修改 ， 如 图 5-79 所 示 。 
PurType: |@PurType ReqNo: |@ReqNo 
@Remark @Desc 


5-79 预览 效果 


44) 再 次 应 用 模板 ， 创 建 采购 申请 行 项 目的 表 元 素 ， 右 击 “RootElement”， 在 弹出 的 快 
捷 菜单 中 选择 “Apply Template”， 如 图 5-80 所 示 。 
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45) WF% “Table”, Pi “Next” F, WA 5-81 所 示 。 


(Oz 


@ Documentation View zie, 


Select Template 


RootElement| 
b [| Insert Child... 


od 


Cut Ctrl+X 
z] 


Creates a table in the view 


Template Instance Name Table 
Copy Ctrl+C 4 
Available Templates: 
Paste Ctrl+V 


E Action Button Creates a table in the view 
E Form 
Table 


Replace With > 


Delete Delete 


Move Up 


Move Down 


Parameter Mapping 


Translatable Texts 


Apply Template 


BS 


Al5-80 ”应 用 目标 的 菜单 选择 


5-81 选择 模板 类 型 


46) 由 于 行 项 目 中 字段 较 多 ， 如 全 部 在 表格 中 显示 ， 会 使 得 页 面 宽度 超出 正常 页 面 ， 不 
便于 用 户 查看 详细 的 数据 信息 ， 而 且 参 考 ECC 系统 中 的 采购 申请 界面 ， 因 此 仅 在 表 元 素 中 
放 和 部 分 字段 ， 剩 余 字 段 都 用 选项 卡 的 方式 在 表格 下 方 进行 显示 ， 如 图 5-82 所 示 。 

47) 可 单 击 右 侧 的 上 、 下 筑 头 按钮 调整 不 同 字 段 的 排列 顺序 ， 也 可 在 完成 创建 后 从 
“Outline” 清单 中 进行 调整 ， 调 整 完毕 后 单 击 “Finish” 按 钮 ， 如 图 5-83 所 示 。 

Ei Apply Template a = 


iE 
pp tem Specify Table Properties 
Select Attributes Edit the properties of the table columns 
Select the node and the attributes that the table will be | 


si ER pleas Attribute Editor Bound Prop... a [4] 
4 AIG) Request. GetPurRegs DeliveryA.. DeliveryAddr (Reques... TextView text b +) 
4 AA GetpurReqs DeliveryC... DeliveryCity (Request... TextView text 四 
E B purReqNo DeliveryD... DeliveryDate (Reques.。 TextView text E 
E B PurReqType Ekorg Ekorg (Request_GetP... TextView text 
4 WD Response Fileld Fileld (Request_GetPu... TextView text 
4 (VQ GetPurReqsResponse IsImp IsImp (Request_GetPu... TextView text 
4 VI Return ItemType ItemType (Request_G... TextView text = 
= P rai A default column header text is set if there is no other type information available. ; 
FUR Purtune In some special models, this could hide potential column header metadata at runtime 
V] Set default header texts for all columns 


=e ® nee 


PS 


5-83 ”调整 元 素 的 类 型 和 位 置 


图 5-82 ”选择 对 应 上 下 文 


48) 保存 所 有 修改 ， 完 成 了 查询 输入 字段 元 素 、 返 回 的 采购 申请 信息 元 素 以 及 行 项 目 信 
息 元 素 的 创建 ， 如 图 5-84 所 示 。 


PurReqNo: ‘@PurReqNo 
PurReaType: @PurReqType 
PurType: @PurType ReqNo: @ReqNo 
(@Remark @Desc 
Remark: Desc: 
[T| DeiveryCiy | count | Area | Account | Adjustvendor | Unt | ModifyDate | ttemType | Lgort | ProcessStatus | Litnr | Ekorg | Werks | CurrType | MatCode |C] 


@DeliveryCity @Count @Area @Account @AdjustVendor @Unit @ModifyDate @ltemType @lgort @ProcessStatus @Lifnr @Ekorg @Werks @CurrType @MatCode 


Al 5-84 视图 预览 效果 
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49) 接着 创建 选项 卡 集 ， 将 其 他 采购 申请 字段 放 和 人 其 中 进行 显示 ， 右 击 “RootEle- 
ment”， 在 弹出 的 快捷 菜单 中 选择 “Insert Child”， 如 图 5-85 所 示 。 
50) 选择 “TabStrip”， 单 击 “OK” 按钮 ， 如 图 5-86 所 示 。 


New UI Elem 


Create a new Ul element 


Select the UI element you want to create. You can also enter an ID for it 


Category Library UI Element 
[all] 2 fall] ^| | [i TabStrip = 
Action Active Components | TextEdit 
Complex Adobe TextView 
Graphic Analytics a @F TimedTrigger 
Integration = Business Graphics E E ToggleButton 
Layout Business Intelligence rss ToggleLink 
Menu Calendar (| | "ToolBar E 
Selection Mobile Add-Ons =P ToolBarButton 
Text | | Office Integration {> ToolBarButtonChoice ~ 
Toolbar 了 | | Pattern Develooment ba 2! m | 3 
ID TabStrip 


Documentation 


i> 


The TabStrip Ul elementis used to display a set of screen areas organized in tabs 


Only the content of the currently selected tab is displayed. A tab may be selected by clicking its 


4 O Bostēlement (©) | OK | | Cancel 
D nsert Child... 
5-85 ”插入 子 元 素 的 菜单 选择 图 5-86 ”选择 元 素 类 型 


51) 接着 右 击 “TabStrip”， 选 择 “Insert Tab”, MA 5-87 所 示 。 

52) 重复 添加 选项 卡 操作 ， 共 添加 3 个 选项 卡 ， 如 图 5-88 所 示 。 

53) 将 3 个 选项 卡 的 “Tab_Header” 标 题 分 别 改 为 “物料 数据 ” “联系 人 ”和 “客户 数 
据 ”， 如 图 5-89 所 示 。 


4 TabStrip 

4 Tab 
T Tab_Header [Header] | 
C] Tab_Content 


TabStrip > By Tabl 物料 数据 联系 人 客户 数据 
&B cd Insert Tab Tab2 | 
Al 5-87 插入 子 元 素 的 5-88 创建 后 的 5-89 运行 效果 
菜单 选择 元 素 清音 


54) 随后 右 击 选项 卡 中 的 透明 容器 “Tab_Content”， 选 择 “Apply Template”， 如 图 5-90 
所 示 。 

55) 在 弹出 的 对 话 框 中 选择 “Form”， 单 击 “Next” 按 钮 ， 如 图 5-91 所 示 。 

56) 选择 需要 在 该 选项 卡 中 显示 的 字段 ， 单 击 “Finish” 按 钮 ， 如 图 5-92 所 示 。 

57) 完成 “物料 数据 ”选项 卡 的 元 素 创建 后 ， 保 存 所 有 修改 ， 如 图 5-93 所 示 。 
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4 TabStrip 
4 Tab 
Select Template 
T Tab_Header [Header] P 
2 pe Creates a form in the view 
PELE 
Ta Insert Child... 
> Ta a Template Instance Name Form 
& Context N % k 
B Copy Available Templates: 
Paste E Action Button [Creates a form in the view 
Replace With E Form -一 -一 - 
X Delete Table 
Move Up 
Move Down 
Parameter Mapping 
Apply Template | 


图 $-90 应 用 目标 的 菜单 选择 图 5-91 选择 模板 类 型 


Apply T z 
Select Attributes 


Select the attributes that the form elements will be bound to 


F] B Locks A 
7| g LongDesc 

B MatCode 

B MatGroup 
[B ModifyDate | 
B Price 

B ProcessStatus 
B ReqDate 

B ReqltemNo 
B ReqNo 

B RegPlanNo 
VB ShortDesc 国 


S| 


< 


m 


ShortDesc: @ShortDesc 
LongDesc: @LongDesc 


Unit_0: @unit 
@ [<Back | Next> |[ Einish ||[ cancel | CEM 


MatCode_0: @MatCode 


Al 5-92 ”选择 对 应 上 下 文 图 $-93 “物料 数据 ”的 预览 效果 


58) 重复 该 选项 卡 的 操作 ， 接 着 创建 “联系 人 ”选项 卡 中 的 元 素 ， 如 图 5-94 所 示 。 
59) 重复 上 述 操作 ， 接 着 创建 “客户 数据 ”选项 卡 中 的 元 素 ， 如 图 5-95 所 示 。 


DeliveryCity_0: @DeliveryCity 

DeliveryDate: @DeliveryDate RegPlanNo: @ReaPlanNo 

Creator: @Creator ProcessStatus_0: v 
Area_0: v AdjustVendor_0: @AdjustVendor 
DeliveryAddr: @DeliveryAddr CurrType_0: X 
ModifyDate_0: @ModifyDate Isimp: o 


BS 


5-94 “联系 人 ”的 预览 效果 图 5-95 “客户 数据 ”的 预览 效 呈 


no 


60) 完成 所 有 配置 后 ， 页 面 的 雏形 已 基本 完成 ， 接 着 创建 应 用 程序 进行 发 布 ， 右 击 
“Applications”， 选 择 “Create Application”， 如 图 5-96 所 示 。 
61) 输入 应 用 程序 的 名 称 ， 随 后 单 击 “Next” 按 钮 ， 如 图 5-97 所 示 。 
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New Applicati = 
Application Properties - 
Enter the properties for the new application I 


Name NewlApp 


Package com.sap.demo.mydynp04.wd.app.newlapp Browse... 


F] Authentication 


4 [BE [LocalDevelopment] mydynp04 
a $ Web Dynpro 
a Applications] @ < Back Next > Finish Cancel 
4 Create Application 


图 5-96 创建 应 用 的 菜单 选择 图 5-97 输入 应 用 名 称 


62) 选择 使 用 已 存在 的 组 件 ， 单 击 “Next” 按 钮 ， 如 图 5-98 所 示 。 
63) 默认 选择 已 完成 配置 的 组 件 和 接口 视图 ， 单 击 “Finish” 按 钮 ， 如 图 5-99 所 示 。 


Select References 


Select References for the Application 


Web Dynpro Component | Dynp04_01Comp - com.sap.demo.mydynp04.wd.com ~ | 


Interface View | Dynp04_01CompinterfaceView 


Startup Plug Default 


Choose Referenced Web Dynpro Component 


You can either reference an existing Web Dynpro component 


Referenced Web Dynpro Component 
© Use Existing Component 
© Create a New Component 


Next > | Einish Cancel 


5-98 选择 组 件 类 型 图 $-99 选择 对 应 引用 


BS 


64) 保存 所 有 修改 ， 右 击 应 用 程序 ， 选 择 “Deploy New Achive and Run”, 415-100 
所 示 。 


4  [LocalDevelopment] mydynp04 
4 $ Web Dynpro 
4 名 Applications 
CA NewlApp 
Open 
Open Data Modeler 


Record 
Delete 


Copy 
Deploy New Archive and Run 


图 $-100 部 署 和 运行 应 用 的 菜单 选择 
65) 运行 后 即 可 对 程序 功能 进行 测试 ， 单 击 “ 查 询 ” 按 钮 可 以 得 到 Web 服务 中 预 设 的 
返回 值 ， 如 图 5-101 所 示 。 
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PurReqNo [ PurReqType: [ 
a2] 


PurType 01 | ReqNo: [010000010000 | 
采购 申请 备注 采购 申请 描述 
Remark. Desc: 
"| DeliveryCity Count Area | Account AdjustVendor | Unit | ModifyDate | ltemType | Lgort | ProcessStatus | Lifnr Ekorg Werks CurtType MatCode 
南京 10 CN 1601030000 10000000001 EA 20120908 01 Z001 A01 0101000020 0001 SD00 01 000000000010000315 


PARE | BRA 客户 数据 


ShortDesc: 电线 \00000065069548' 
LongDesc: [400000065069548] 


Unit_0: [EA 
MatGroup: G001 
MatCode_0: 000000000010000315) 


图 5-101 预览 效果 


5.2.3 视图 元 素 调整 


在 项 目 开发 过 程 中 ， 功 能 测试 通过 标志 着 代码 部 分 工作 已 基本 完成 。 本 节 将 对 之 前 完成 
的 页 面 进行 布局 和 位 置 的 优化 。 

开发 实例 : 

1) 优化 查询 表单 ， 采 用 3 * 30 界面 设计 。 即 每 一 行 有 3 个 属性 ，8 个 元 素 ， 每 个 元 素 
General Width 为 100% ， 通 过 控制 Layout Width 页 面 布局 。 每 个 属性 的 Label a Tex- 
tValue 分 别 占 10% 45 20% , # FAY 20% 通过 添加 HorizontalGutter 来 补足 。 

2) 首先 选中 查询 条 件 的 透明 容器 (第 一 个 TransContainer) ， 将 它 一 般 属性 中 的 “Lay- 

ut” 布 局 修改 为 “GridLayout”， 随 后 进入 布局 属性 ， 将 “colCount” 改 为 “8”， 如 网 5-102 
所 示 。 
3) 在 “Outline” 视 图 中 批量 选中 所 有 的 页 面 元 素 ， 如 图 5-103 ran. 


ET RootElement 
General peer ESE 日 - 口 TransContainer_0 
Layout cellPadding 0 
cellSpacing 0 0 
colCount 8 
stretchedHorizontally true 
stretchedVertically true 
= eee 
图 5-102 属性 修改 图 5-103 元素 清 单 
pe fr os ” hs » “ ” oraz? 
4) 将 它们 的 “width” 属 性 设置 为 “100% ”， 如 图 5-104 所 示 。 
caa Property | value 
General = Properties [Label] 
LayoutDate contextMenuBehavi our inherit* 
contextMenul d 
enabled true 
textDirection inherit 
tooltip & 
visible visible 
width 100% 


KI 5-104 属性 修改 


注 : 批量 选中 视图 元 素 时 ， 属 性 页 签 中 显示 的 是 这 些 元 素 的 共有 属性 ， 修 改 属 性 值 会 应 
用 至 所 有 选中 的 视图 元 素 。 
5) FREE (Cul) 键 批 量 选 中 两 个 “lable” 标 签 元 素 ， 将 它们 的 “width” 属 性 设置 为 
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LR 


“10% see 如 
6) 同样 
“90% Pe 如 


5-105 所 示 。 
批量 选中 两 个 “InputField” 输入 框 元 素 ， 
5-106 所 示 。 


ce 


Hb, 将 它们 的 “width” 属性 设置 为 


Ba 


EL] RootElement 
EL | TransContainer_0 
T et label 
rReqNo 


T ee label 


三 PurReqType 
TP Sel 


EP Sel 


图 


5-105 ”元 素 清单 1 


7) 插入 “HorizontalCutter” 分 制 线 ， 并 在 布局 属性 中 将 “width” 改 为 “5% ”， 
属性 中 的 “visible” 改 为 “blank” 空 白 。 

8) 随后 将 两 个 标签 的 “text” 属性 分 别 修改 为 “采购 申请 号 ”和 “申请 类 型 ”， 
有 修改 ， 如 图 5-107 所 示 。 


图 


5-106 元素 清 单 2 


将 一 般 


保存 所 


[zwe [@PurReahio 申请 类 型 : 。 [@PurReaType za] | 
PurType: @PurType ReqNo: @ReqNo f | 
@Remark @Desc 


K| 5-107 页 面 预 览 效 果 


9) 接 下 来 优化 返回 信息 的 页 面 元 素 ， 首 先 添加 “Group”， 并 将 返回 元 素 的 透明 容器 、 
表 和 选项 卡 集 拖 忠 至 新 建 的 组 中 ， 如 图 5-108 所 示 。 

10) 修改 组 的 抬头 文本 描述 ,将 “text” 属 性 修改 为 “采购 申请 返回 ”。 

11) 按照 步骤 1) ~6)， 以 同样 的 方式 返回 信息 的 透明 容器 “TransContainer_0_0”， 
图 5-109 所 示 。 


如 


. ox. 
12) 将 “Remark_label” 和 “Dese_label” 的 布局 属性 中 的 “vAlign” 改 为 “top”， 即 靠 
$ > = 
近 文 本 框 的 顶部 ， 如 图 5-110 所 示 。 
EN] Grow T Label 
T Group_Header [Header] G | 4 LayoutData [GridData] 
aL] C 0.0 enera cellBackgroundDesign transparent* 
T PurType_label LayoutData colSpan i 
Ti PurType 
一 HorizontalGuttert dragData — 
T ReqNo_label hAlign beginOfLine* 
{Fae Reglo height 
= WE ter2 paddingBottom none 
En D Remark Tabe paddingLeft none 
gu Ce til! Remark paddingRight none 
oup_Header [Header] — Hori zontelGutter3 : 
f-{_] TransContainer_0_0 T Desc label paddingTop none 
由 - 转 Table 0 E] Dese vAlign top| z 
H-E TabStrip — Hori zontalGutterd width 10% 
图 5-108 ”元 素 清单 3 图 5-109 元素 清单 4 图 5-110 修改 属性 


13) 随后 将 4 个 “label” 标 签 的 “text” 文 本 属性 分 别 修改 为 “申请 类 型 ” “备注 ”“ 采 
购 申请 ”和 “描述 ”， 随 后 保存 所 有 修改 ， 如 图 5-111 所 示 。 


14) 对 于 表格 元 素 ， 
所 示 。 
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将 所 有 列 的 “Header” 标 题 修改 为 对 应 的 中 文 描述 


， 如 图 5-112 


采购 申请 返回 
ake. @Purtype 采购 申请 [@ReaNo 
SE @Remark HE @Desc 
图 5-111 视图 预览 效果 1 
RA 
m| 交 贷 城市 数量 区 域 科目 推荐 供应 商 单位 | 修改 日 期 MARS | 库存 地 点 | 处 理 状态 | 供应 商 | 采购 组 织 | 工厂 Reka 物料 编码 | 
站 @DeliveryCity @Count @Area @Account @AdjustVendor @Unit @ModifyDate @itemType @Lgort @ProcessStatus @lLifnr @Ekorg @Werks @cCurrType @MatCode 
| | @peiveryciy @Count @Area @Account @AdjustVendor @Unit @ModifyDate @temType @Lgort @ProcessStatus @lLifnr @Ekorg @Werks @CurrType @MatCode 
| | @Deliverycity @Count @Area @Account @AdjustVendor @Unit @ModifyDate @itemType @Lgort @ProcessStatus @lLifnr @Ekorg @Werks @CurrType @MatCode 
图 
图 5-112 视图 预览 效果 2 
A 37 [Ge =e ; my] + Sy [oe ee a i > 
15) 最 后 根据 实际 需要 ， 调 整个 别 元 素 的 实际 宽度 和 位 置 ， 保 存 所 有 修改 ， 并 重新 编 
s \ 一 /一 y a — 
译 、 运 行 ， 可 以 看 到 优化 后 的 页 面 ， 如 图 5-113 所 示 。 
采购 申请 号 : 申请 类 型 E] 
采购 申请 返回 
申请 类 型 : 01 采购 申请 : [010000010000 
TE 采购 申请 备注 描述 EE 
行 项 目 
D 交 货 城市 | 数量 ke “科目 推荐 供应 商 单位 | 修改 日 期 行 项 目 类 别 库存 地 点 = 处理 状态 。 “ HEM 
| 请 南京 10 CN 1601030000 10000000001 EA 20120908 01 Z001 A01 0101000020 
物料 数据 | 联系 人 | 客户 数据 
短 描述 电 红 \00000065069548\ 液 压 支架 电 液 控 制 肉 \DBT 进 口 
长 描述 。 ”| 电缆 \00000065069548 以 压 支 架 电 液 控制 疗 \DBT\ 进 口 
may: [EA 
物料 组 : [C001 
物料 编码 :|000000000010000315 
图 5-113 ”运行 效果 


注 : 在 实施 项 目 过 程 中 ， 一 方面 界面 需要 参考 用 户 原 始 系统 中 的 操作 习惯 以 及 界面 风 
格 ， 另 一 方面 也 要 务必 与 业务 顾问 及 用 户 进行 确认 。 


5.3 延伸 配置 


1. SAP 企业 门户 ( Portal) 
在 SAP NetWeaver 架构 中 ， 企 业 门 户 既 是 用 户 访问 系统 的 统一 人口 ， 也 是 WD4J 应 用 程 
序 默认 的 应 用 系统 。 在 Web Dynpro 应 用 程序 开发 完成 后 ， 需 要 进一步 在 企业 门户 中 将 应 用 
程序 以 门户 视图 的 形式 添加 至 菜单 和 角色 中 。 在 完成 门户 内 容 配置 之 后 ， 用 户 在 登录 企业 门 
户 后 也 就 能 访问 与 他 角色 权限 相符 合 的 页 面 菜 单 以 及 应 用 程序 清单 。 
至 于 权限 控制 的 概念 ， 在 Web Dynpro 中 ,可 以 通过 代码 或 者 上 下 文 绑 定 来 控制 不 同 角 
色 用 户 看 到 个 性 化 的 应 用 页 面 ， 甚 至 限制 使 用 应 用 程序 中 的 部 分 功能 ， 所 以 程序 内 的 权限 控 
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制 都 是 在 Web Dynpro 中 完成 ; 在 企业 门户 中 ， 则 是 将 整个 Web Dynpro 项 目 作为 一 个 对 象 进 
行 添加 和 分 配 ， 所 以 对 于 企业 门户 中 的 权限 控制 决定 了 用 户 是 否 能 看 到 对 应 应 用 程序 的 访问 
链接 。 开 发 人 员 需 要 了 解 并 分 清 属于 开发 控制 内 容 ， 还 是 属于 门户 配置 控制 内 容 。 

2. SAP 业务 流程 管理 (BPM) 

如 果 企 业 门 户 的 目标 是 将 所 有 系统 的 人口 统一 起 来 ,那么 SAP 业务 流程 管理 的 目标 就 
是 将 所 有 系统 的 业务 流程 也 统一 到 一 个 平台 中 。 

SAP 业务 流程 管理 作为 SAP NetWeaver 平台 的 重要 组 成 部 分 ， 提 供 了 设计 、 业 务 流程 建 
模 、 实 施 、 运 行 、 流 程 运行 监控 的 一 整套 工具 ， 帮 助 SAP 的 客户 机 与 SAP 已 有 的 应 用 模块 
实现 自动 化 的 业务 流程 ， 跨 越 不 同 的 系统 来 控制 和 提升 业务 流程 的 运行 效率 。 

除了 业务 流程 需要 单独 的 BPM 流程 驱动 引擎 外 ， 所 有 BPM 的 页 面相 关内 容 和 业务 数据 
处 理 逻 辑 均 通过 WD4) 技术 实现 。 
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67% SAP 企业 门户 


企业 门户 以 其 特有 的 系统 入 口 统一 性 、 多 平台 视图 页 面 的 集成 性 以 及 日 益 增长 的 企业 信 
息 化 对 于 门户 的 依赖 性 ， 正 逐渐 成 为 企业 系统 信息 化 的 重要 环节 。 本 章 介绍 SAP 企业 门户 
的 一 些 关 键 内 容 ， 以 及 企业 门户 与 Web Dynpro 开发 相关 的 配置 ， 当 然 也 同样 会 提供 具体 的 
开发 实例 供用 户 参 考 。 


6.1 门户 与 企业 门户 


6.1.1 门户 


在 20 世纪 末 ， 互 联网 兴起 、 门 户 萌芽 时 期 ， 网 站 还 都 处 于 基础 的 页 面 展示 阶段 ， 以 
内 门户 网 站 为 例 ， 大 多 以 新 闻 信 息 为 主要 内 容 ， 而 这 样 的 门户 只 能 算是 一 个 信息 门户 ， 而 并 
非 企业 真正 需要 的 门户 。 在 不 断 地 优化 升级 后 ， 门 户 已 经 从 简单 的 网 页 门户 ， 到 企业 信息 平 
台 ， 再 到 企业 应 用 集成 ， 最 终 成 为 了 一 个 用 户 可 以 高 效 协 作 的 平台 。 当 然 ， 如 今 的 企业 门户 
也 是 一 个 提供 给 用 户 单 点 登录 不 同业 务 系统 、 优 化 业务 流程 并 且 可 以 无 颖 地 将 各 种 企业 应 用 
整合 至 浏览 器 端 界面 的 平台 。 

从 个 人 角度 来 看 ，SAP 的 企业 门户 为 所 有 的 企业 应 用 提供 了 一 个 统一 的 和 人口， 弱化 了 企业 
中 各 种 各 样 的 “系统 ”， 为 不 同系 统 中 的 业务 进行 串联 和 整合 提供 了 基础 ， 并 将 在 企业 门户 平 
台 上 开发 的 功能 成 为 企业 门户 中 的 “应 用 ”。 在 今天 SAP 的 HANA 云 平台 大 行 其 道 的 时 候 ， 从 
某 个 角度 来 看 ， 企 业 门户 也 可 以 算是 为 企业 用 户 提供 了 一 个 “私有 云 "。 两 者 的 不 同 之 处 在 
于 ， 企 业 门户 的 出 现 是 因为 先 有 了 不 同 的 业务 系统 、 复 杂 的 业务 流程 和 多 样 化 的 数据 存储 ， 后 
出 现 了 NetWeaver 的 架构 从 不 同 层次 进行 整合 ， 也 就 是 想 把 老 积 木 放 进 一 个 沙盘 中 ; 而 SAP 的 
HANA 云 平台 从 一 开始 就 想 要 把 原来 的 积木 推倒 重 来 ， 随 后 再 根据 不 同 企业 的 业务 、 不 同行 业 
的 标准 以 及 不 同 客户 的 需求 具体 实施 细 化 的 解决 方案 (如 基于 Fiori 的 App 应 用 ) ， 也 就 是 提供 
了 一 个 更 大 的 沙盘 ， 不 仅 可 以 放下 以 前 的 积木 ， 还 会 提供 更 多 的 新 应 用 。 


6.1.2 SAP 企业 门户 


SAP 企业 门户 (SAP Enterprise Portal, SAP EP) 是 一 个 包含 了 知识 管理 和 协作 服务 的 复杂 
门户 架构 ， 基 于 SAP 封装 中 的 Web Dynpro For Java 语言 进行 开发 实现 ， 系 统 中 有 和 多样 化 的 业 
务 内 容 和 组 件 ， 用 于 保证 系统 的 快速 实施 以 及 方便 用 户 使 用 。 它 的 核心 功能 有 以 下 几 个 方面 。 

e 门户 架构 : 提供 了 SAP 企业 门户 的 基本 功能 ， 并 且 保 证 基于 浏览 器 的 多 种 信息 访问 ， 

集成 了 应 用 、 信 息 和 流程 等 不 同 内 容 。 

o 协作 : 提供 给 使 用 者 可 以 进行 高 效 协作 的 一 个 平台 ， 可 以 实现 虚拟 聊天 室 、 基 础 论坛 

等 功能 ， 而 且 也 可 以 与 共享 电子 邮件 、 日 历 等 控件 进行 集成 。 
e 知识 管理 : 可 以 对 企业 的 非 结构 化 数据 进行 管理 。 在 SAP ERP 的 生态 中 ， 结 构 化 数 
据 管理 有 对 应 的 数据 仓库 (BW) 系统 ， 而 非 结构 化 的 数据 就 通过 门户 中 的 “知识 管 
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理 ” 功 能 来 进行 存储 和 访问 。 

SAP 企业 门户 为 了 降低 总 体 拥有 成 本 (TCO) 而 做 了 很 多 的 努力 ， 从 系统 的 后 台 配 置 到 
前 端的 用 户 体验 ， 门 户 都 提供 了 一 些 相 关 的 工具 。 

多 平台 支持 : 当 用 户 部 署 程序 (并 不 限于 Web Dynpro 程序 ) 到 SAP NetWeaver 应 用 

服务 器 时 ， 支 持 不 同 的 操作 系统 环境 ， 不 论 是 UNIX 系统 还 是 微软 的 Windows 服务 

器 ， 平 台 都 有 成 熟 的 监控 管理 机 制 。 

e 业务 包 : 除了 SAP 企业 门户 本 身 自 带 的 一 些 内 容 ， 它 还 允许 部 署 和 运行 第 三 方 的 业务 
包 进 行 功 能 扩展 。 业 务 包 包含 了 一 些 预 定义 的 门户 内 容 ， 可 以 方便 地 集成 到 门户 
a 

多 语言 支持 : 为 了 适应 跨 地 区 、 跨 国家 的 多 语言 公司 ，SAP 企业 门户 提供 了 超过 20 
言 进行 配置 ， 并 可 以 通过 语言 配置 向 导 实 现 自动 翻译 。 

o 远程 门户 网 络 : 如 果 企 业内 有 不 同 版 本 的 SAP 企业 门户 ,或 者 需要 将 两 个 或 多 个 企业 
门户 联合 起 来 进行 访问 ， 就 可 以 通过 远程 门户 网 络 的 配置 ， 提 供用 户 统一 入 口 的 无 缝 
集成 体验 。 

访问 SAP 企业 门户 默认 的 地 址 是 ，http:// < ServerHost > : < ServerPort > /irj， 随 后 在 登 

录 界 面 输入 对 应 的 用 户 名 和 密码 即 可 登录 ( 其中， 服务 器 域名 由 局 域 网 的 DNS 域名 服务 器 
决定 ， 而 服务 器 端口 可 以 在 系统 中 进行 自 定义 配置 )。 在 使 用 默认 的 管理 员 账 号 “Adminis- 
tator” 登录 后 ， 可 以 看 到 企业 门户 的 默认 页 面 和 框架 ,最 上 方 包含 企业 Logo、 搜 索 栏 和 相 
关 链接 ， 第 二 行 是 系统 页 面 菜单 ， 下 方 的 文件 夹 则 是 企业 门户 的 角色 对 应 的 顶层 目录 ， 下 方 
则 是 页 面 的 具体 内 容 显 示 ， 如 网 6-1 所 示 (该 图 以 NetWeaver 7.4 的 企业 门户 为 例 ， 而 门户 
整体 页 面 的 框架 、 链 接 索 引 都 可 以 通过 系统 的 主题 和 界面 配置 进行 个 性 化 。 


Ey 搜索 : QQ ”新 的 会 话 | sap store | 注销 
(BE 前 进 ， 历史 记录 收藏 天 个 性 化 设置 视图 帮助 欢迎 : 请 PRBS 
Dh " m 
ts i I 
内 容 管理 用 户 管 理 系统 管理 
门户 内 容 管 理 PASH ， 门户 显示 we 资源 的 资源 库 KAS | 协作 内 容 | 工作 流 内 容 。 内 容 统计 
内 容 管理 > 门户 内 容 管理 2R DAR ~ 
》 我 的 对 象 AR) [a] 
》 我 的 未 决 更 改 列表 
门户 内 容 
BR: [HALF A hat id ze 
er Sac PRETE | ERE 
> ONAAS 
， 站 业务 对 象 m= ”管理 任务 | 更 改 管理 
> ORE FPN 生产 者 (ER 访问 SAP NetWeaver 管理 员 "Ey 管理 您 的 更 改 列表 
， 尼 门户 应 用 程序 提 世 到 SAP NetWeaver hù 提供 可 以 查看 和 管理 更 约 列 表 的 
= n 更 改 列表 组 织 器 ”工具 的 直接 访 
b Lia WSRP Content p 访问 身 [ERIR ERRET 
faae eee ee A SE oes RENMEI 
详细 视图 色 的 权限 的 中 心 工具 的 访问 $ aoe 
国 ERRETES, 如: 配 署 门户 服务 BBS 
在 SAP NetWeaver 管理 员 中 
HAS ARIA. EE BA 
DIFE 您 可 以 本 利和 管理 门户 服务 展 ， 可 用 来 创建 、 查 看 及 释放 传输 
nis = PRIR o aua 请 求 。 


图 6-1 SAP 企业 门户 登录 后 的 页 面 


拥有 管理 员 权 限 的 用 户 在 登录 后 就 能 看 到 企业 门户 的 “内 容 管 理 ”“ 用 户 管理 ”和 “ 系 
统管 理 ” 三 大 块 配置 内 容 。 下 面 重点 介绍 SAP 企业 门户 中 与 Web Dynpro 开发 相关 的 一 些 配 
置 内 容 。 
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6.2.1 门户 内 容 介 绍 


SAP 企业 门户 的 内 容 包 括 了 门户 中 所 有 的 标准 内 容 (角色 、 页 面 等 ) 以 及 通过 配置 添 
加 自 定义 的 对 象 ， 而 这 些 对 象 主要 有 4 种 类 型 ， 见 表 6 -1。 
表 6 -1 门户 对 象 的 类 型 
门户 内 容 定 义 
门户 视图 是 门户 内 容 中 最 基本 的 单位 ， 它 支持 从 不 同 的 系统 获取 信息 以 进行 展示 ， 如 果 将 门 
户 想 象 为 一 张 报纸 ， 那 iView 就 是 组 成 门户 的 那些 文章 。 企 业 门户 中 View 的 优势 在 于 支持 从 不 
同 的 系统 获取 信息 以 进行 展示 ， 包 括 ERP 系统 (企业 资源 管理 系统 ) CRM 系统 (客户 关系 管 
理 系 统 ) 、 网 页 以 及 BW 报表 (数据 仓库 系统 ) 等 不 同 架 构 
一 个 页 面 可 以 包含 一 个 或 多 个 iView， 或 者 其 他 的 页 面 ， 它 们 依照 一 定 的 布局 进行 排列 。 页 
可 以 被 分 配给 工作 集 或 者 角色 ， 在 用 户 调用 该 页 面 时 就 可 以 显示 相应 的 内 容 


工作 集 将 门户 视图 和 页 面 以 树 状 结构 的 形式 组 织 在 同一 个 目录 中 ， 工 作 集 本 身 则 作为 一 种 通 
的 、 可 重用 的 内 容 结构 提供 给 角色 


iView 门户 视图 


Page 页 面 


Workset 工作 集 


角色 是 内 容 实体 中 最 高 级 的 实体 ， 所 有 的 其 他 实体 都 需要 分 配给 角色 才能 展示 给 用 户 。 角 色 
Role 角色 同样 也 代表 企业 门户 系统 中 的 页 面 链接 查看 权限 ， 视 图 、 页 面 和 工作 集 都 不 能 分 配给 用 户 ， 只 
有 角色 可 以 被 分 配给 用 户 
一 般 来 说 ， 角 色 的 分 配 会 存在 一 个 “角色 -TER - -门户 视图 ”这 样 一 
的 关系 ， 但 在 实际 配置 中 ， 它们 之 间 的 美 系 可 以 非常 灵活 ， ee 
看 到 ， 最 右 侧 是 零散 的 视图 和 页 面 ， 其 中 红色 方块 表示 poaa i 


门户 视图 ， 蓝 色 方 块 表示 页 面 ， 它 们 既 可 以 分 配给 工作 
集 ， 也 可 以 跳 过 工作 集 直 接 分 配给 角色 ; 而 同样 的 情 
况 ， 工 作 集 也 可 以 分 配给 另 一 个 工作 集 ， 角 色 也 可 以 分 
配给 另 一 个 角色 。 在 整个 角色 的 树 状 结构 中 ， 其 实 不 管 
是 角色 或 是 工作 集 ， 扮 演 的 都 是 一 个 文件 夹 的 作用 ， 所 
以 图 中 也 使 用 了 文件 夹 的 图 标 进行 表示 。 唯 一 要 牢记 的 
是 ， 只 有 角色 可 以 分 配给 用 户 。 

对 于 Web Dynpro 开发 的 应 用 程序 ， 运 行 时 都 会 以 
网 页 的 形式 进行 展现 ， 并 且 每 一 个 应 用 程序 都 有 一 个 独特 的 URL 链接 。 对 于 用 户 来 说 ， 并 
不 需要 拿 到 一 个 链接 清单 进行 一 一 的 访问 ， 这 时 就 需要 企业 门户 统一 地 将 Web Dynpro 开发 
的 应 用 通过 门户 视图 进行 集成 并 以 菜单 形式 展现 。 在 内 容 管理 中 ， 将 会 完成 页 面 的 配置 、 葬 
单 的 定义 以 及 角色 的 创建 与 分 配 。 

在 实际 的 项 目 应 用 中 ， 一 般 会 把 所 有 开发 的 应 用 复制 到 一 个 统一 的 项 目 文件 夹 下 ， 以 便 
于 管理 和 维护 ;然后 针对 不 同 的 功能 或 分 类 ， 建 立 不 同 的 子 文件 夹 以 及 菜单 所 属 的 角色 ， 并 
将 应 用 与 角色 关联 在 一 起 ， 最 后 利用 页 面包 含 、 工 作 集 归 类 、 角 色 分 配 以 及 内 容 对 象 的 互相 
包含 完成 整个 门户 应 用 的 配置 。 

下 面 将 详细 地 介绍 如 何 将 Web Dynpro 程序 通过 SAP 企业 门户 中 页 面 角色 的 配置 向 用 户 
进行 展示 (截图 都 是 以 新 版 本 的 门户 进行 展示 ， 界 面 与 老 版 本 的 EP 7. 0 界面 稍 有 不 同 ) 。 

277 


图 6-2 门户 对 象 之 间 的 关系 


6.2.2 门户 页 面 创建 


从 逻辑 角度 来 说 ，Web Dynpro MH (EAR 包 ) 的 部 署 其 实 仅 仅 是 将 程序 发 布 到 了 
NetWeaver 的 Java 应 用 服务 器 上。 虽然 一 般 情况 下 这 个 服务 絮 也 同时 是 SAP 企业 门户 的 服务 
fit, 但 Web Dynpro 程序 并 没有 在 门户 中 存在 一 个 真正 的 对 象 ， 这 就 需要 进行 以 下 的 配置 操作 。 

配置 实例 : 

1) 首先 使 用 有 管理 员 权 限 的 账户 登录 门户 系统 ， 在 默认 的 内 容 管理 页 面 下 ， 可 以 看 到 
若干 系统 自 带 的 文件 夹 目 录 ， 如 图 6-3 所 示 。 

2) 单 击 选中 “门户 内 容 ”"”， 随 后 右 击 并 选择 “新 建 ” 一 “文件 夹 ”"， 如 图 6-4 所 示 。 


b RHR 
我 的 未 决 更 改 列表 
v OP AS 
ae: [BABES | [FE] 
高 级 查获 查 基 和 若 搁 
> (OFA 
> Late 
» OZE FPN 生产 者 
> (p OPARE 
> ($a WSRP Content 
> [和 Web Dynpro Java YEE 
> (Fy Portlet VEE 新 建 > 


ĀE > 
打开 >) 工作 集 
详细 视图 全 
I) 区 区 域 呈 示 结构 化 对 象 明细 ， 如 : ez | i 
国 gee 刷新 View > 
[Py res ae 布局 
国王 s KAR 
到 6-3 门户 内 容 中 默认 的 目录 结构 图 6-4 创建 文件 夹 的 菜单 选择 


3) 在 右 侧 显示 的 创建 文件 夹 向 导 中 ， 在 对 象 名 称 文本 框 中 输入 “项 目 内 容 "， 在 “对 
象 标 识 ” 文 本 框 中 输入 “proj”， 随 后 单 击 “ 下 一 步 ”按钮 ， 如 图 6-5 所 示 。 

4) 确认 文件 夹 相关 信息 填写 正确 ， 随 后 单 击 “ 完 成 ”按钮 完成 创建 。 创 建 这 样 一 个 自 
定义 文件 夹 的 目的 是 为 了 更 好 地 进行 门户 内 容 的 管理 :后 续 相关 的 内 容 都 会 放 入 这 个 文件 
Je, 方便 了 维护 管理 以 及 最 终 上 线 的 传输 工作 ， 如 图 6-6 所 示 。 


4 = * | 下 一 步 | ER] 


a E-P] TF N | [2X 到 清 


将 在 文件 实 中 创建 以 下 内 容 :。 portal_content 


对 象 标识 “要 自动 创建 标识 ， 则 保留 此 闻 象 为 空 ) : 有 
bol TERE RAR commyprojectro 


文件 兴 ID Prefix (Example: com.companyname): 


主语 言 : 
com.myproject Description: 


图 6-5 输入 文件 来 信息 图 6-6 确认 文件 夹 信 息 


5) 接着 在 目录 中 找到 “Web Dynpro Java 应 用 程序 ”并 展开 目录 ， 这 个 结 点 下 显示 了 服 
务 器 已 经 成 功 部 署 的 所 有 WebDynpro 工程 ， 包 括 所 有 的 标准 应 用 和 自 定 义 开 发 程序 ， 找 到 
需要 进行 显示 的 Web Dynpro 应 用 程序 的 名 称 ， 如 图 6-7 所 示 。 
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6) 展开 Web Dynpro 工程 名 称 ， 会 出 现 对 应 工程 所 包含 的 应 用 程序 (有 可 能 会 存在 多 个 
应 用 程序 ) ， 单 击 选 中 应 用 程序 ， 如 图 6-8 所 示 。 


，》 站 门户 内 容 ， 哨 mydynpo1 
》 Otane > Ee mydynpo2 
》 门 远程 FPN 生产 者 > [ES mydynpo3 
> (TARR » [ej mydynpo 
> (a WSRP Content > EE mydynpo7 

pats ssi ; i mare 
Jier A 


图 6-7 Web Dynpro 应 用 程序 对 应 目录 6-8 选中 Web Dynpro 应 用 程序 


7) 随后 右 击 该 应 用 程序 ， 在 弹出 的 快捷 菜单 中 选择 “复制 ” ， 如 图 6-9 所 示 。 
8) 返回 最 开始 创建 的 自 定 义 文 件 夹 “项 目 内 容 ”， 布 击 文件 夹 ， 如 图 6-10 所 示 。 


>» (meee 
复审 - nese 
复制 标识 > 站 门户 用 户 

门户 管理 员 
BHPRHATR + (mass 


图 6-9 操作 菜单 图 6-10 “门户 目录 中 自 定义 文件 来 


9) 在 弹出 快捷 菜单 中 选择 “粘贴 作为 PCD 对 象 ”， 如 果 之 前 的 复制 动作 没有 成 功 完成 ， 
这 里 的 快捷 菜单 中 就 不 会 出 现 “粘贴 作为 PCD 对 象 ” 的 菜单 选项 ， 如 图 6-11 所 示 。 

10) 在 右 侧 显示 的 创建 页 面 的 向 导 中 ， 在 对 象 名 称 文本 框 中 输入 “请 假 申 请 ”， 在 对 象 
标识 文本 框 中 输入 “ReqApp”， 随 后 单 击 “ 下 一 步 ” 按 钮 ， 如 图 6-12 所 示 。 


[ie E-a] h | [元 或 |[ 取消 
vib REE * 
= sees 
复制 标识 
对 象 标识 《要 自动 创 建 标识 , WREAFRAZ) 
zi [ReqApp 
更 改 标识 页 画 ID Prefix (Example: com.companyname): 
[com.myproject] 
站 贴 作为 PCD 对 象 zee 
BMARANR ex 辣 
图 6-11 粘贴 对 象 的 菜单 选择 图 6-12 输入 对 象 信息 


11) 确认 页 面相 关 信 息 填 写 正确 ， 单 击 “ 完 成 ”按钮 完成 创建 ， 如 图 6-13 所 示 。 
12) 右 击 该 页 面 ， 在 弹出 的 快捷 菜单 中 选择 “预览 "， 如 图 6-14 所 示 。 


图 6-13 创建 后 的 效果 图 6-14 操作 菜单 


13) Web Dynpro 程序 将 会 在 新 窗口 中 运行 ， 可 以 对 页 面 进行 预览 ， 如 图 6-15 所 示 。 
完成 上 述 配置 后 ， 一 个 Web Dynpro 程序 才 从 Java 应 用 服务 器 上 的 “程序 ”真正 地 集成 
到 了 一 个 企业 门户 的 “页 面 ” 中 。 
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pzs 

请 假 人 | 

Hz: | 

iO: [ta] 
原因 : 


图 6-15 运行 效果 


6. 2.3 ”门户 角色 的 创建 和 分 配 


通过 角色 权限 的 配置 ， 就 可 以 实现 针对 不 同 用 户 展示 不 同 的 内 容 。 例 如 ， 业 务 操作 员 可 
以 在 门户 中 看 到 自己 使 用 的 业务 操作 界面 ， 而 他 却 不 能 看 到 业务 分 析 报表 ; 企业 管理 层 的 门 
户 可 以 展示 业务 分 析 报表 ， 而 他 却 不 需要 展示 业务 操作 界面 。 

在 SAP 企业 门户 中 ， 页 面 无 法 直接 分 配给 用 户 ， 必 须 经 过 “角色 ”的 封装 和 管理 ， 才 
能 赋 巴 用户 进 行 展示 。 门 户 的 角色 在 内 容 开 发 工作 室 中 创建 ， 角 色 中 除了 包含 页 面 对 象 之 
外 ， 还 需要 设 定 内 容 在 门户 中 的 导航 结构 ， 即 在 门户 中 的 访问 菜单 和 路 径 。 

开发 实例 : 

1) 返回 最 开始 创建 的 自 定 义 文件 夹 “项 目 内 容 "， 碳 击 文件 夹 ， 在 弹出 的 快捷 菜单 中 
选择 “新 建 ” 一 “角色 ”一 “自由 式 角色 ”， 如 图 6-16 所 示 。 

2) 在 右 侧 显示 的 创建 角色 向 导 中 ， 在 “对 象 名 称 ”“ 对 象 标识 ”和 “角色 ID Prefix” 
文本 框 中 分 别 输入 “人 事 管理 ”“PR_HRMNG” il “com. myproject”， 随 后 单 击 “ 下 一 步 ” 
按钮 ， 如 图 6-17 所 示 。 


而 上 一 步 | 下 一 步 >) | (eR 
MRE 
Aste 
对 象 标识 (CHSAUMRRR. MRBXFRAD | 
[中 He | 
新 建 H Be ob 工作 中 心 锡 色 AS ID Prefix (Example: com.companyname): 
打开 > IFS Saree |com.myproject | 
一 一 一 | 来 自 后 端的 角色 主语 言 
搜索 >| Re ease 
图 6-16 创建 角色 的 菜单 选择 图 6-17 输入 角色 信息 


3) 确认 角色 相关 信息 填写 正确 ， 随 后 单 击 “ 完 成 ”按钮 完成 创建 ， 在 文件 夹 中 即 会 出 
现 所 创建 的 对 象 ， 如 图 6-18 所 示 。 

4) 接着 选中 新 建 的 角色 ， 右 击 并 选择 “打开 ”一 “角色 ”， 如 图 6-19 所 示 。 
打开 > ae 


y (RBA 属性 
- 吊 人 事 管理 分 析 许可 


图 6-18 创建 后 的 目录 图 6-19 ”操作 菜单 
5) 接着 选中 之 前 创建 的 页 面 ， 右 击 并 选择 “将 页 面 添加 到 角色 ”一 “ 增 量 链接 ”， 
如 图 6-20 所 示 。 如 果 未 提前 打开 角色 ， 右 击 页 面 后 不 会 出 现 “ 将 页 面 添加 到 角色 ”的 选 
项 。 这 里 添加 的 两 种 方式 “ 增 量 链接 ”和 “复制 ”， 可 以 分 别 理解 为 创建 了 一 个 快捷 方式 
以 及 复制 创建 了 一 个 新 的 对 象 。 使 用 “ 增 量 链接 ”的 添加 方式 ， 如 果 原 始 页 面 属性 发 生 
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变化 ， 则 角色 中 的 对 应 增 量 链接 也 会 跟随 着 同步 改变 ; 如 果 使 用 “复制 ”方式 进行 添加 ， 
则 不 会 同步 改变 。 

6) 在 添加 完成 后 ， 在 右 侧 的 角色 内 容 显 示 中 ， 就 能 看 到 角色 的 一 个 树 状 结构 ， 选 中 角 
色 右 侧 的 “入 口 点 ”， 完 成 角色 配置 。 入 口 点 是 在 门户 中 显示 的 一 级 主 菜 单 ， 也 是 通过 门户 
进入 子 页 面 的 切入 点 ， 选 择 角色 为 入 口 点 ， 门 户 会 以 角色 内 容 为 一 级 菜单 依次 显示 导航 结构 
菜单 ， 如 图 6-21 所 示 。 


角色 内 容 
新 建 4|| 77 || £0 |= [+3] F#3 I ES DERES 
2 Acs AR 排序 优先 级 合并 
BRUSHES | HEE > Asse K Mo 1o00 总 
-| 复制 F maets [ | 100.0 是 * 
图 6-20 操作 菜单 图 6-21 角色 配置 


7) 右 侧 可 以 看 到 导航 结构 的 预览 (如 果 仅 匀 选 “请 假 申 请 ”页 面 ， 则 在 预览 中 也 仅 会 
显示 “请 假 申 请 ”一 级 菜单 ) ， 如 图 6-22 所 示 。 

8) 在 完成 了 角色 分 配 的 操作 后 ， 最 终 需 要 将 角色 分 配给 ra = 
指定 的 用 户 ， 该 用 户 登录 后 才能 正确 地 看 到 为 他 所 配置 的 Web | “SSE 
Dynpro 页 面 。 首 先进 入 用 户 管理 ， 创 建 一 个 测试 用 户 ， 单 击 
“创建 用 户 ”按钮 ， 如 图 6-23 所 示 。 图 6_22 预览 效果 

9) 输入 登录 标识 (用户 ID)、 定 义 密码 、 确 认 密 码 、 姓 


氏 和 和 名字， 如 图 6-24 所 示 。 


ZEE | 账户 信息 | SAES | 附加 信息 | BHRARE 
登录 标识 : * test01 
@ 定义 初始 密码 
门生 成 密码 
搜索 条 件 : [RP |w|| 二 [EZA (Bae 个 禁用 密码 
UARA | E0HREF || [EF] | (SU) Re [Sere] | [FE eet a 
尼 主体 类 型 状态 有 登录 标识 = | 名 称 
G) 加 入 搜索 参数 并 选择 “执行 ” 姓氏 : * [01 
名 字 tes 
图 6-23 搜索 用 户 界 面 图 6-24 输入 用 户 信息 
10) 填写 完 基本 信息 后 ,切换 到 “已 分 配 的 角色 ”页 签 (图 6-24 最 右 侧 页 签 ) ， 页 签 
中 会 出 现 左右 两 个 表格 ， 左 侧 “ 可 用 角色 ” ee ae 表 


示 已 分 配给 当前 用 户 的 角色 ， 如 图 6-25 所 示 。 


[Fails 
fox || (RF A 

常规 信息 账户 信息 联系 信息 附加 信息 分 醒 的 角色 = 分配 的 组 

可 用 角色 分 醒 的 角色 

搜索 条 件 : | 所 有 数据 源 v| 现行 搜索 条 件 : | 所 有 数据 看 ~] 现行 

to. 名 称 = | 描述 数据 源 To. 名 称 = | 描述 数据 源 
回 输入 搜索 参数 并 选择 “执行 ” 回 输入 搜索 参数 并 选择 “执行 ” 

Eam O| BE 


图 6-25 Enf tri 
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11) 在 左 侧 输 入 需要 搜索 的 角色 关键 字 ， 此 处 输入 “ * HRMNG =” Mii “WIT” f 
钮 ， 下 方 会 显示 搜索 结构 ， 选 中 该 角色 后 ， 单 击 下 方 的 “添加 ”按钮 ， 如 图 6-26 所 示 。 


可 用 的 角色 

BRR: TERE |w|*HRMNG* Re 

Ro. 26 = 描述 tee 
H fai i 多 ped:portal_contenticommyproj... 人 人 事 管理 门户 角色 


图 6-26 搜索 可 用 角色 


12) 添加 完成 后 ， 和 角色 会 出 现在 右 侧 的 “已 分 配 的 角色 ”中 ， 表 示 和 角色 分 配 完成 ， 随 
后 单 击 “ 保 存 ” 按 钮 完成 用 户 的 创建 和 角色 分 配 ， 如 图 6-27 所 示 。 


已 分 配 的 角色 

搜索 条 件 : FENER e 

BR. 名称 = ”描述 数据 滨 
Ry pcd:portal_content/com.myproj... AFFE HARE 


图 6-27 查看 已 分 配角 色 


13) 注销 门户 系统 ,使 用 刚才 创建 的 “test01” 登 录 后 (首次 登录 可 能 需要 修改 密码 )， 
就 能 看 到 实际 配置 的 Web Dynpro 的 页 面 ， 目 录 结 构 与 在 角色 中 的 预览 结构 相同 ， 如 图 6-28 
所 示 。 


人 事 管理 
请 假 申 请 


AFER > 请 假 申请 


6.2.4 多 级 菜单 配置 


在 完成 上 述 的 配置 后 ， 了 解 到 门户 页 面 的 简单 配置 过 程 包括 页 面 创建 和 角色 分 配 。 当 然 
在 实际 项 目 实施 中 很 多 复杂 的 功能 模块 会 对 应 于 多 个 门户 人 口 ， 不 同 菜单 下 又 会 有 不 同 的 子 
菜单 ， 同 时 要 求 不 同 组 织 架 构 的 人 能 够 分 配 不 同 的 功能 权限 或 子 功 能 权限 ， 这 就 需要 在 角色 
配置 中 实现 多 级 菜单 的 展示 。 


在 门户 中 多 级 菜单 配置 主要 有 以 下 3 种 方式 : 中 在 角色 中 创建 文件 夹 〈 不 是 企业 门户 中 的 
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文件 夹 ) ， 通 过 文件 夹 的 层次 结构 来 实现 多 级 菜单 ; @) 额 外 创建 门户 对 象 “ 工 作 集 ”， 通 过 工 
作 集 实现 多 级 菜单 并 分 配给 角色 进行 展示 ; 多 个 角色 的 互相 藤 套 ， 从 而 实现 多 级 菜单 。 

第 一 种 方式 ， 在 角色 中 直接 创建 文件 夹 的 效果 更 为 直接 和 明显 ， 适 用 于 简单 的 菜单 结 
构 ; 另外 两 种 方式 则 适用 于 多 角色 ， 但 角色 与 角色 之 间 同 时 存在 个 别 差异 的 情况 。 例 如 ， 财 
务 部 门 用 户 和 人 力 资源 部 门 用 户 有 各 自 不 同 的 业务 处 理 页 面 ， 但 他 们 又 同时 可 以 查询 几 十 、 
上 百 张 的 公司 基本 信息 报表 ， 在 门户 配置 中 ， 不 可 能 为 财务 部 角色 和 人 力 资源 部 角色 分 别 创 
建 内 部 文件 夹 进行 报表 页 面 添加 ， 而 是 将 这 些 基 本 信息 报表 统一 汇总 至 一 个 工作 集 或 角色 
中 ， 再 进行 具体 的 管理 和 分 配 。 而 具体 是 使 用 工作 集 进 行 管 理 ， 还 是 使 用 角色 进行 管理 ， 就 
需要 根据 项 目 情况 进行 评估 ， 如 果 不 需 要 有 和 额外 的 子 角色 ， 建议 还 是 使 用 工作 集 进行 管理 
可 以 尽量 地 减少 后 期 用 户 、 角 色 的 维护 管理 工作 。 

接着 将 通过 一 个 实例 来 具体 分 析 两 种 配置 方式 ， 模 拟 的 多 级 菜单 见 表 6 -2。 

表 6 -2 模拟 的 多 级 菜单 


一 级 菜单 二 级 菜单 三 级 菜单 
人 事 管理 考勤 考勤 录入 
(其 他 子 菜单 ……) 
1. 角色 内 配置 


1) 首先 选中 新 建 的 角色 ， 右 击 并 选择 “打开 ”一 “角色 ”， 如 图 6-29 所 示 。 
2) 在 右 侧 的 角色 内 容 中 ， 单 击 “ 新 建 ”按钮 ， 如 图 6-30 所 示 。 


角色 内 容 
am a | 77 ||| [Se EO | 221] Se | | [Sees] | [3 7s) Sate | wate 
25 入 口 点 可 见 排序 优先 级 
~ HAses wv 器 100.0 
[a zeae z 100.0 
图 6-29 ”操作 菜单 图 6-30 角色 配置 


3) 在 弹出 的 下 拉 菜 单 中 选择 “文件 夹 "， 如 图 6-31 所 示 。 
A) 在 弹出 的 对 话 框 中 输入 文件 夹 名 称 “ 考 勤 ” 作 为 二 级 菜单 ， 随 后 单 击 “ 确 定 ” 按 
钮 ， 如 图 6-32 所 示 。 


来 自 模板 的 View 
来 自 远程 源 的 View 


图 6-31 创建 文件 夹 菜 单 选择 图 6-32 输入 文件 夹 名称 
5) 完成 创建 后 ， 可 以 在 角色 内 容 中 看 到 实际 效果 ， 如 图 6-33 所 示 。 


图 6-33 角色 配置 
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6) HEP REN CASE, JPEN Ase PHB VSIA UI, GR “ERE” AT 
式 添 加 到 “考勤 ”目录 下 ， 如 图 6-34 所 示 。 


名称 入 口 点 BEJ 
jy Daissa M v 
-~ (45 v 

+ Fase, v 


图 6-34 角色 配置 

7) 角色 内 容 的 右 侧 仍然 可 以 看 到 导航 结构 的 预览 ， 如 图 6-35 所 示 。 

8) 接着 再 次 使 用 测试 用 户 test01 进行 登录 后 ， 就 能 看 到 更 新 后 的 三 级 目录 了 ， 如 
图 6-36 所 示 。 


人 人事 管理 
从 事 管理 > SE > SERA 
请 假 申 请 
申请 单 号 : 
WRA: 
姓名 : 
导航 结构 预览 申请 日 期 : ta] 
v 人事 管 理 原因 : 
#5 
， 考勤 录 入 
提交 
图 6-35 ”导航 结构 预览 6-36 ”运行 效果 


2. 工作 集 配 置 
1) 返回 最 开始 创建 的 自 定义 文件 夹 “ 项 目 内 容 ”， 右 击 文件 夹 ， 如 图 6-37 所 示 。 
2) 在 弹出 的 菜单 中 选择 “新 建 ” 一 “工作 集 ”， 如 图 6-38 所 示 。 


E > 
打开 > 
az ， 
ag 
分 析 
6-37 TIP ARERR 6-38 操作 菜单 


3) 在 “工作 集 名 称 ” 和 “工作 集 标识 ”文本 框 中 分 别 输入 “考勤 ”和 “Atten”， 如 
图 6-39 所 示 。 

4) 接着 选择 新 建 的 工作 集 ， 右 击 选择 “打开 工作 集 *， 右 侧 将 显示 工作 集 内 容 ， 可 以 
看 到 “工作 集 内 容 ” 和 “角色 内 容 ” 的 菜单 ， 如 图 6-40 所 示 。 


RM: 


THERE: * 
#5 


工作 集 标识 
Atten 


工作 和 集 标识 前 组 “例如 : com. 公 司 名 称 ) ae a | TF || Ed ESSH ELD 
com.myproject| 匀称 


本 
žit: | + Das vj 


图 6-39 ”输入 文件 夹 信息 图 6-40 工作 集 配置 
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5) 接着 将 页 面 添加 至 工作 集 ， 在 打开 工作 集 的 前 提 下 ， 右 击 需 要 添加 的 页 面 ， 选 择 
“将 页 面 添加 至 工作 集 ” 一 “ 增 量 链接 ”， 如 图 6-41 所 示 。 
6) 完成 页 面 添加 后 ， 工 作 集 中 就 能 看 到 完成 后 的 目录 结构 ， 如 图 6-42 所 示 。 


TERRAE 
Aea E 
2% 入 6 点 可 见 
SRGSRLES | HEEE 7 (48 
Zl . Fase 口 Vv 


图 6-41 操作 菜单 图 6-42 工作 集 配置 


7) 打开 “人 事 管理 ”角色 ， 再 选中 工作 集 ， 右 击 并 选择 “将 工作 集 添加 到 角色 ”一 “ 增 
量 链接 ”， 如 图 6-43 所 示 。 

8) 在 “角色 内 容 ” 中 就 能 看 到 工作 集 添 加 完成 后 的 效果 ， 同 时 工作 集 下 面 的 子 对 象 也 
会 同样 添加 至 角色 中 ， 如 图 6-44 所 示 。 


Er = 

新 建 4|| 77 ||| Se So | SSS ||| Fs | | SS | Te) | [5278 | ata 
冬 称 入 口 点 TR 排序 优先 级 a2 
~ Asta v 100.0 = 
~ 465 v 100.0 是 * 
+ M45 z 100.0 Bt 
ES | mas] | | 7 CAH 口 回 100.0 = 
一 一 一 一 一 一 一 | 复制 EE ENN v 100.0 是 * 

图 6-43 ”操作 菜单 6-44 角色 配置 


9) 随后 使 用 测试 用 户 登 录 门 户 ， 就 能 看 到 完成 两 种 配置 后 的 门户 页 面 ， 如 图 6-45 
所 示 。 


6-45 ”运行 效果 


10) 取消 选中 文件 夹 目 录 中 的 “可 见 ” 复 选 框 ， 如 图 6-46 所 示 。 


角色 内 容 
新 建 4|| 77 | | [ie | Be | 复制 |[ ae | lf REESE | | Ee | Ts | | ESAL 
26 入 口 点 . FR 排序 优先 级 

”~ Dasz 可 了 100.0 
= O45 100.0 
画 。 ser 口 加 100.0 
E 4a v 100.0 
| | + masz 口 回 100.0 


6-46 角色 配置 
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11) 导航 结构 预览 中 会 出 现 修改 后 的 菜单 概览 ， 如 图 6-47 所 示 。 
12) 随后 使 用 测试 用 户 登 录 门 户 ， 就 能 看 到 其 中 一 个 二 级 菜单 已 被 隐藏 ， 如 图 6-48 
所 示 。 


> 考勤 录入 
PRS Ci 
下 人 事 管理 
-aN 
， 考 勤 录 入 
图 6-47 导航 结构 预览 运行 效果 


3. 角色 间 配 置 

除了 以 上 两 种 方式 以 外 ， 其 实 角色 之 间 也 可 以 互相 骨 套 ， 被 添加 的 角色 作为 另 一 个 角色 
的 子 结 点 ， 而 实际 门户 中 的 显示 菜单 则 同样 通过 “人 入 口 点 ”的 设置 来 决定 。 

1) 首先 在 文件 夹 中 新 建 一 个 “考勤 ”的 门户 角色 ， 右 击 文件 夹 进行 创建 ， 如 图 6-49 


所 示 。 
2) 随后 打开 角色 ， 并 以 增 量 链 接 的 形式 添加 需要 展示 的 页 面 ， 如 图 6-50 所 示 。 


LL = SS 
Fn 
2H Acs 可 见 排序 优先 级 
y Han iv) v 100.0 
| . Raza v 100.0 
图 6-49 文件 夹 内 容 图 6-50 ”角色 配置 


3) 接着 ， 先 选中 并 打开 分 配给 用 户 的 “人 事 管理 ”角色 ， 青 选择 将 要 添加 的 “考勤 ” 
角色 ( 见 图 6-51)，, 右 击 “ 考 勒 ” 并 选择 “将 角色 添加 到 角色 ”一 “ 增 量 链 接 ”。 

4) 仍 保持 “人 事 管理 ”的 入 口 点 为 选中 状态 ， 在 右 侧 的 导航 结构 预览 可 以 看 到 对 应 的 
菜单 结构 ， 如 图 6-52 所 示 。 由 于 第 一 个 文件 夹 类 型 的 “考勤 ”为 不 可 见 ， 因 此 预览 里 只 有 
两 个 “考勤 ”目录 。 


角色 内 容 = 
[am | a3 || [Se] So || Se 5 | EAN Es 

匀称 入 口 点 WR 排序 优先 级 

ies 5 - = SAHAR 了 
L | > Os o o 100.0 DIETE 

| > has 回 100.0 r35 

| ~ >s 口 7 100.0 > #5 

+ Raza z 100.0 


图 6-51 角色 配置 图 6-52 ”导航 结构 浏览 


5) 使 用 测试 用 户 登 录 企 业 门 户 后 ， 就 能 看 到 实际 的 菜单 效果 了 ， 如 图 6-53 所 示 。 
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AFER > SB > 考勤 录入 


请 假 申请 


申请 单 号 : 
WRA: 


HE: 
申请 日 期 : 
原因 : 


图 6-53 运行 效果 


6.2.5 多 样 化 的 视图 模板 


企业 门户 提供 了 非常 多 的 模板 用 于 创建 门户 视图 ， 部 分 类 型 只 需要 通过 门户 中 的 一 些 向 
导 配 置 ， 而 一 些 涉 及 后 台 系统 数 据 处 理 、 催 辑 交 互 的 页 面 ， 则 需要 通过 Web Dynpro 进行 二 
次 开发 才能 在 门户 中 完成 无 颖 集成 ， 如 图 6-54 所 示 。 

下 面 以 较为 简单 的 URL 类 型 的 门户 视图 创建 为 例 ， 对 配置 过 程 进行 介绍 。 

开发 实例 : 

1) 首先 在 自 定义 文件 夹 中 ， 创 建 一 个 新 文件 夹 “iView” (参考 之 前 的 创建 过 程 ， 右 击 
“创建 ”) ， 用 于 管理 接 下 来 创建 的 测试 视图 ， 如 图 6-55 所 示 。 

2) 接着 选择 新 建 的 “iView” 文 件 夹 并 右 击 ， 在 弹出 的 快捷 菜单 中 选择 “新 建 ” 一 
“iView” 一 “来 自 模板 的 iView”， 如 图 6-56 所 示 。 


可 用 模板 
查找 : 现行 [清除] | Jabs 


© BEx Web 应 用 程序 View (SAP BW 3x 格 式 ) 

O BEx Web 应 用 程序 View (SAP NetWeaver 7.0 格式 》 
O crystal 企 业 报表 

O Dynamic List 

O JDBC 存储 程序 View 

O KM Folder Settings Admin View 

O KM Indexing Monitor View 

O KM Taxonomy Update Log View 

O KM Trex 3%] View 

© KM XML Forms Builder Check View 

O KM XML Forms Builder View 

O Microsoft PowerPoint 的 分 析 

O SAP BSP View 

O SAP IAC View 

O SAP RFC View 

O URL View 

O 〇 WPC 2.0 Navigation iview 

O WPC Web Content View 

O Web 服务 View 

O XML View 

口 代理 到 门户 View (WSRP) 

口 协作 配置 模板 复制 标识 
口 工作 集 映射 View _ 
OARS RRR View WES 

口 没有 内 容 过 滤器 的 KM 文档 View ,A iv 一 改 标识 
口 相关 服务 View $i 
口 针 对 移动 本 机 应 用 程序 启动 器 的 View 了 
口 门户 活动 报表 View (este 添加 到 我 的 对 象 


图 6-54 不 同类 型 的 iView 图 6-55 创建 后 的 目录 结构 图 6-56 操作 菜单 
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3) 在 右 侧 新 建 View 的 向 导 中 选中 “URL iView” 单 选 按钮 ， 随 后 单 击 “ 下 一 步 ” 按 
钮 ， 如 图 6-57 所 示 。 

4) 输入 新 建 视图 的 名 称 、 标 识 和 标识 前 级 ， 随 后 单 击 “下 一 步 ” 按 钮 ， 如 图 6-58 
所 示 。 

5) 由 于 选择 的 是 互联 网 链接 类 型 的 视图 ， 因 此 需要 输入 对 应 的 URL 链接 ， 同 时 右 侧 也 
有 按钮 可 以 进行 网 页 的 预览 ， 用 于 确认 输入 的 地 址 是 否 正确 。 本 实例 使 用 之 前 已 发 布 至 服务 
器 端的 dynp08 工程 应 用 程序 的 链接 ， 如 图 6-59 所 示 。 


名 称 : * 


HEFE 
View 标识 : 
© SAP BSP View View 标识 前 组 (例如 : com .公司 名 称 ): 
RFC view com. myproject| 
( 2.0 Navigation iview 主语 言 : 
C WPC Web Content View 


图 6-57 ”选择 类 型 图 6-58 ”输入 对 象 信息 


6) 在 完成 门户 视图 的 创建 后 ， 在 相应 的 目录 中 就 能 看 到 已 创建 的 对 象 ， 如 图 6-60 
所 示 。 

7) 接着 将 视图 添加 至 工作 集中 ， 首 先 右 击 工作 集 并 打开 ， 随 后 右 击 视图 ， 并 选择 “将 
iView 添加 到 工作 集 ” 一 “ 增 量 链接 ”， 如 图 6-61 所 示 。 


vy (CO REAS 
= (MEW 
sere 
A URL= _ _ __ > 门人 事 管理 将 View 深 加 到 工作 条 >| aaas | 
lhttp://<IP>:50100/webdynpro/resources/demo.sap.comimydynp08/ReqApp > 后 勤 竺 理 复制 


图 6-59 输入 对 应 链接 图 6-60 创建 后 的 对 象 图 6-61 操作 菜单 


8) 右 侧 工作 集 内 容 中 就 会 出 现 添加 完成 后 的 效果 ， 如 图 6-62 所 示 。 


~ hee v 
| + Rasta a 加 
-Baita v 


图 6-62 ”工作 集 配置 


9) 由 于 之 前 工作 集 与 角色 也 是 增 量 链接 的 关系 ， 因 此 打开 角色 查看 时 会 发 现 ， 角 色 中 
也 已 同步 添加 了 新 建 的 门户 视图 ， 如 图 6-63 所 示 。 

10) 使 用 测试 用 户 登 录 企 业 门 户 后 ， 就 能 看 到 新 增 的 菜单 以 及 测试 页 面 ， 如 图 6-64 
所 示 。 


| ~ Rhases 


OK 


> (hae 
~ hae 口 
， [sess 
， sess O 


<| ki RIR ER 


K 6-63 工作 集 配置 图 6-64 ”运行 效果 
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63 ”用户 管理 


SAP 企业 门户 中 的 用 户 管 理 是 通过 系统 的 用 户 管理 引擎 (User Management Engine, 
UME) 进行 运转 和 管理 的 ， 而 使 用 管理 员 账 号 登录 后 看 到 的 “用 户 管理 ”页 面 只 是 UME 的 
一 小 部 分 。UME 是 由 连接 至 底层 SAP Java 应 用 服务 器 以 及 管理 所 有 用 户 和 组 原始 数据 的 存 
储 的 一 系列 用 户 管理 服务 组 成 的 ， 所 以 门户 中 的 应 用 程序 不 需要 单独 访问 用 户 数据 和 服务 ， 
而 是 通过 UME 进行 集中 的 管理 ， 如 图 6-65 所 示 。 


外 部 应 用 访问 UME SAP 企业 门户 


UMERE: 登录 界面 | 用 户 管理 界面 

umes 单 点 登录 /认证 。 ”用户 档案 管理 BERE 

UME API 层 用 户 API 账号 API 用 户 组 API 角色 API ACL API 
UME 核 心 层 用 户 会 话 保 持 管 理 一 用 户 会 话 答复 管理 


持续 层 


数据 库 LDAP 目 录 ABAP 系 统 第 三 方 系统 


图 6-65 UME 整体 架构 示意 图 


虽然 整个 UME 的 架构 看 起 来 有 点 吓人 ， 但 在 实际 配置 中 ， 大 部 分 的 工作 都 是 在 “UME 
的 展现 层 ” 中 的 “用 户 管理 ”界面 完成 的 。 用 户 管理 一 共 包 含 了 以 下 3 个 对 象 : 

e User (HF): 对 应 企业 门户 账号 的 实际 用 户 ， 可 维护 基本 信息 、 包 含 角 色 、 分 配 的 

组 以 及 与 其 他 系统 的 用 户 映射 。 

© Role (AE): 在 内 容 管理 中 进行 定义 ， 在 用 户 管理 中 进行 分 配 ， 可 分 配给 用 户 或 

者 组 。 

© Group (组 ) : 在 用 户 管理 中 进行 定义 ， 可 以 与 角色 和 用 户 进行 双向 的 分 配 。 

用 户 可 以 分 配 多 个 角色 ， 也 可 以 分 配 多 个 组 ， 角 色 的 组 合 可 以 归 集 到 一 个 组 ， 同 时 角色 
与 活动 或 操作 关联 ， 来 间接 地 实现 门户 中 用 户 角色 或 组 的 不 同 显示 不 同 的 页 面 活动 与 操作 。 
当然 这 里 的 角色 也 不 仅仅 限于 门户 角色 ， 所 有 的 后 人 台 角 色 和 后 台 组 都 遵循 这 个 关系 。 三 者 之 
间 的 组 合 也 十 分 灵活 。 


6.3.1 账号 管理 


进入 SAP 企业 门户 的 用 户 管理 页 面 ， 首 先 看 到 的 是 一 个 搜索 页 面 ， 可 以 输入 关键 字 并 
选择 对 应 的 搜索 内 容 (包括 用 户 、 角 色 和 组 ) 进行 查询 ， 也 支持 带 “ * ”的 模糊 查询 。 在 
搜索 结果 过 多 时 ， 默 认 只 会 显示 200 条 记录 。 
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1. 创建 和 修改 
首先 介绍 如 何 创建 一 个 用 户 ， 以 及 用 户 信息 的 修改 。 
开发 实例 : 
1) 进入 “用 户 管理 ”页 面 ， 单 击 “ 创 建 用 户 ” 按 钮 ， 如 图 6-66 所 示 。 注 意 ， 根 据 搜 
索 条 件 的 不 同 ， 创 建 按钮 会 同时 发 生变 化 。 
搜索 
搜索 条 件 : | 用 户 v| MAER | A] [高级 搜索 


ORAA || 夏 制 到 新 用 户 ] | (male | | (wees [ite ][ 生 成 新 密码 ] | [FE 


图 6-66 ”搜索 用 户 界面 


2) 接着 下 方 会 出 现 填写 用 户 详细 信息 的 页 面 ， 输 入 “登录 标识 ”“ 定 义 密码 ”“ 确 认 密 
码 ” 和 “ 姓 ” 即 可 完成 最 基本 的 一 个 用 户 创建 ， 如 需要 添加 组 或 者 角色 ， 则 分 别 在 “分 配 
的 组 ”和 “分 配 的 角色 ”页 签 中 进行 配置 ， 如 图 6-67 所 示 。 

EE 
tzal 
(ae KARS | KARS | 附加 信息 | SMARS | 分 本 的 组 


FFI: * test01 

回 定 义 初始 密码 

〇 禁用 密码 

定义 密码 : * [ove 
确认 密码 :eeveee 


姓 :* test01 
名 : 

电子 邮件 地 址 : 
称谓: 

语言 : [S| 
激活 可 存 取 性 功能 : C 
安全 策略 : ‘me v] 


N 


6-67 输入 用 户 信息 


3) 同时 ,也 可 以 对 该 用 户 定义 具体 的 账户 信息 ， 如 图 6-68 所 示 。 


详细 信息 
修改 || AR ][ 取消] 
常规 信息 账户 信息 | 联系 信息 附加 信息 O 分 配 的 角色 “分 本 的 组 


已 锁定 的 用 户 账 户 : 器] 选择 以 设置 管理 锁 。 取消 选 择 以 解除 管理 和 密码 锁 
账户 有 效 起 始 日 期 : 
账户 有 效 结束 日 期 : ta 


图 6-68 维护 账户 信息 界面 


4) 定义 具体 的 联系 信息 ， 如 图 6-69 所 示 。 
5) 由 于 初始 密码 是 管理 员 在 创建 用 户 时 进行 设置 的 ， 因 此 新 用 户 默认 在 首次 登录 时 ， 
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需要 修改 密码 。 在 首次 登录 修改 密码 后 ， 就 可 以 正常 地 登录 和 使 用 了 ， 如 图 6-70 所 示 。 

Ez te 
修改 ] | [保存 ][ 取 消 
常规 信息 ”| 账户 信息 | 联 系 信息 ”| 附加 信息 | 分 本 的 角色 ”， 分 本 的 组 


时 区 取消 


图 6-69 维护 联系 信息 界面 图 6-70 JAP SIE ety Ah 

2. 解锁 与 锁定 

用 户 账号 有 “可 用 ”和 “锁定 ”两 种 状态 ， 在 锁定 状态 下 ， 账 户 将 无 法 登录 。 在 尝试 
登录 失败 次 数 过 多 时 ， 或 者 管理 员 手 动 进行 账号 锁定 ， 都 会 使 得 账号 处 于 “锁定 ”状态 。 

1) 当 测 试 账号 test01 因为 密码 输入 错误 次 数 过 多 而 锁定 时 ， 使 用 管理 员 账 号 登录 企业 
门户 ， 搜 索 “test01” 用 户 ， 在 查询 结果 中 可 以 看 到 ， 上 账户 的 状态 是 “锁定 ”状态 ， 网 标 显 
示 为 灰色 ， 如 图 6-71 所 示 。 

2) 如 需要 解锁 ,首先 在 表格 中 选中 该 条 目 (该 用 户 所 在 行 )， 接 着 单 击 “解锁 ”按钮 ， 
如 图 6-72 所 示 。 


让 | 主体 类 型 状态 有 登录 标识 = 
|â LOD testo 
Rat: | 后记 v [test01 RF || 高 级 搜索 
UARA | 复制 到 新 用 户 | | [He] | || PH] Re | Saves || | 导出 
图 6-71 已 锁定 用 户 图 6-72 解锁 对 应 用 户 


3) 会 弹出 一 个 提示 解锁 的 原因 的 文本 框 ， 可 以 输入 一 些 提醒 消息 给 用 户 ， 单 击 “ 解 
锁 ” 按 钮 即 可 ， 如 图 6-73 所 示 。 
4) 解锁 后 ， 用 户 状态 恢复 正常 ， 如 图 6-74 所 示 。 


SEERA. 提供 进 行 忒 操作 的 原因 。 这 将 被 记录 到 每 个 用 户 的 帐户 历史 记录 中 


a AEE Re EFF 2 
unlock BE { 全 test01 
| 
EE 
图 6-73 输入 解锁 原因 图 6-74 解锁 后 的 用 户 状态 


5) 如 果 用 户 忘 记 了 登录 密码 ， 解 锁 账 户 并 不 能 帮助 用 户 解 决 问题 ， 则 需要 进行 重 置 密 
码 的 操作 。 还 是 选中 需要 修改 密码 的 用 户 ， 单 击 “ 修 改 ” 按 钮 ， 随 后 单 击 “账户 ”信息 的 
页 签 ， 输 入 “定义 密码 ”和 “确认 密码 ”， 单 击 “保存 ”按钮 即 可 ， 如 图 6-75 所 示 。 

6) 由 于 企业 门户 的 安全 设置 ， 如 果 账 号 不 是 技术 类 型 用 户 (一 般 用 户 均 不 建议 使 用 该 
用 户 类 型 ) ， 则 在 登录 时 会 提醒 首次 登录 需要 修改 密码 ， 如 图 6-76 HR 
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eBid: = USERO1 EREA 
pr En. | 
禁用 密码 新 密码 * 
定义 密码 : # [ER HAE * 
ME [ee | 取消 


图 6-75 修改 用 户 信 息 界面 图 6-76 ”用 户 登 录 时 修改 密码 界面 


7) UME 默认 的 用 户 安全 策略 为 “默认 ”与 “技术 用 户 ”。 普 通 的 前 台 用 户 创 建 时 安全 
策略 为 默认 ， 默 认 的 安全 策略 设置 (如 密码 管理 、 登 录 标识 限制 等 ， 都 会 对 前 台 用 户 生效 。 
由 于 系统 间 通 信 的 用 户 验证 往往 不 需要 频繁 地 去 做 密码 变更 ， 因 此 这 时 就 需要 创建 技术 用 户 
作为 后 台 配 置 的 用 户 验证 。 这 个 属性 也 沿袭 了 SAP 在 ERP 系统 中 的 用 户 类 型 。 具 体 在 修改 
用 户 信息 时 ， 可 以 在 基本 信息 中 看 到 “安全 策略 ”以 及 对 应 的 可 选 类 型 ， 如 图 6-77 所 示 。 

3. 用 户 组 配置 

用 户 角色 的 分 配 在 6.2.3 节 已 进行 过 介绍 ， 接 着 通过 一 个 实例 介绍 用 户 组 的 创建 和 
配置 。 

1) 首先 创建 一 个 测试 用 的 用 户 组 ， 将 “搜索 条 件 ” 中 的 搜索 类 型 改 为 “组 ” (默认 是 
“用 户 ”) ， 随 后 单 击 “创建 组 ”按钮 ， 如 图 6-78 所 示 。 


ekt 
Be: 
电子 邮件 地 址 : 
ne 
zt: f m 
= eae] | HE] [FE 
图 6-77 用 户 信息 的 安全 策略 图 6-78 创建 组 的 操作 页 对 


2) 在 表格 下 方 出 现 用 户 组 的 具体 信息 ， 输 入 唯一 名 称 、 描 述 后 保存 即 可 ， 如 图 6-79 所 
示 。 如 果 需 要 分 配角 色 ， 则 进入 “已 分 配 的 角色 ”页 签 ， 参考 用 户 的 角色 的 分 配 进行 添加 
即 可 。 


上 基本 信息 出 |” SHENAE 已 分 配 的 父 项 组 已 分 配 的 于 组 已 分 配 的 用 户 ARTIKE RH 


R| 6-79 输入 组 名 称 

3) 接着 再 测试 一 下 将 用 户 组 分 配给 角色 首先 将 搜索 条 件 改 为 “角色 ”， 单 击 “ 创 建 角 
色 ” 按 钮 ， 如 图 6-80 所 示 。 

4) 输入 角色 的 唯一 名 称 和 描述 ， 随 后 进入 “分 配 的 组 ”页 签 ， 如 图 6-81 所 示 。 


叭 至 称 :+ [ROLE01 


搜索 条 件 : (AE v| | 所 有 数据 源 v EF 


描述 ROLE01 


图 6-80 创建 角色 的 操作 页 国 


图 6-81 输入 角色 信息 
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5) 在 左 侧 可 以 搜索 用 户 管理 中 定义 的 用 户 组 ， 


添加 后 会 出 现在 右 侧 ， 如 图 6-82 所 示 。 


回 输入 搜索 参数 并 选择 “执行 ” 


| 个 改 || [保存 [取消 
常规 信息 分 配 的 组 ”分配 的 用 户 已 分 配 的 操作 系统 访问 的 用 户 映射 
可 用 的 组 分 配 的 组 
搜索 条 件 : | 所 有 数据 不 ~ LAT 搜索 条 件 : MAIER ~ aT 
Bl | 名 称 = | 描述 数据 源 fa) .| 名称 = | 描述 数据 源 


回 输入 搜索 参数 并 选择 “执行 ” 


图 6-82 ”修改 分 组 的 界面 


6) 添加 完成 后 ， 单 击 “ 保 存 ” 按 钮 即 完成 所 有 配置 ， 如 图 6-83 所 示 。 
已 分 本 的 组 
搜索 条 件 : [FERE | 
| =| 28 2 | a8 Pato 
& GRPO1 GRPO1 UME Sd 


图 6-83 查看 已 分 配 的 组 


在 实施 的 项 目 场 景 中 ， 尤 其 是 项 日 上 线 时 ， aus 输入 men : RE 
管理 员 不 可 能 像 之 前 的 配置 页 面 一 样 ， 一 个 一 | a 
个 地 手动 去 创建 用 户 ， 这 时 就 需要 使 用 脚本 进 | amet: 
行 用 户 的 批量 导入 。 

开发 实例 : a 


1) 首先 单 击 “ 输 入 ”， 进 入 批量 导入 的 页 
面 ， 如 图 6-84 所 示 。 

2) 导入 数据 支持 两 种 方式 : 一 种 是 本 地 文 
FEE, 一 种 是 直接 录入 脚本 的 文本 内 容 进 行 导入 ， 如 图 6-85 所 示 。 参 考 导入 脚本 如 下 : 


图 6-84 导入 数据 界 国 


[ User | 

uid = test01 

last_name =01 

first_name = test 

accessibility =0 

role = ped; portal _ content/com. myproject. proj/com. myproject. f _ hrmng/ com. myproject. PR _ 
HRMNG; 

[ User | 

uid = test02 

last_name =02 

first_name = test 

accessibility =0 
role = ped; portal 
HRMNG; 


content/com. myproject. proj/com. myproject. f _ hrmng/com. myproject. PR _ 


287 


wirkt: 


[User] 
uid=test01 


last_name=01 

first_name=test 

accessibility=0 

role=pcd:portal_content/com.myproject. proj/com.myproject. f_hrmng/com.myproject.PR_HRMNG; 
[User] 

uid=test02 

last_name=02 


first_name=test 
accessibility=0 
role=pcd:portal_content/com.myproject. proj/com.myproject. f_hrmng/com.myproject.PR_HRMNG; 


Z 


6-85 ”脚本 参考 

iE: 脚本 文件 为 TXT 格式 ,文件 内 容 与 录入 脚本 需要 遵守 同样 的 编码 规范 。 

3) 在 脚本 录入 之 后 或 选择 本 地 脚本 文件 后 ， 选 中 “覆盖 现 有 数据 ” 复 选 框 ， 单 击 “ 上 
载 ” 按 钮 ， 如 图 6-86 所 示 。 


Z 


6-86 ”上 载 数据 界面 


4) 在 页 面 中 会 返回 所 有 导入 结果 ， 对 于 系统 已 存在 的 用 户 将 进行 覆盖 ， 而 对 于 不 存在 
的 用 户 则 会 自动 根据 脚本 中 的 信息 进行 创建 ， 如 图 6-87 所 示 。 


了 [到 加 到 导入 


全 部 (2) 
p| 状态 


| | 己 更 新 


已 创建 


显示 名 称 
test01 
test02 


唯一 名 称 
test01 
test02 


图 6-87 导入 数据 结果 


5) 单 击 任意 一 个 用 户 可 以 查看 完整 的 导入 记录 ， 如 图 6-88 所 示 。 
6) 进入 用 户 查 询 界面 也 可 以 看 到 对 应 用 户 已 被 创建 ， 如 图 6-89 所 示 。 


搜索 条 件 : 用 户 v| MSE ”| [test* | ART] [高 级 搜索 
完成 导入 记录 = 

DRAA ][ 夏 制 到 新 用 户 ] | [W3]! E 

D 主体 类 型 RS | 登录 标识 = | 名 称 

ls @ testo1 test01, 

“3 O — testo2 test02, 


图 6-88 详细 的 导入 记录 


图 6-89 查看 已 创建 的 用 


注 : 脚本 导入 这 个 方法 可 以 用 于 批量 的 用 户 创建 ， 也 可 以 用 于 角色 创建 和 用 户 组 创建 ; 还 可 
以 对 用 户 进行 批量 的 密码 初始 化 和 角色 分 配 ， 但 在 进行 脚本 操作 前 ， 建 议 对 现 有 用 户 进行 备份 。 

7) 如 果 需 要 对 现 有 用 户 进行 备份 ， 在 用 户 搜索 的 界面 ， 选 中 需要 备份 的 用 户 ， 随 后 单 
击 “ 导 出 ”按钮 即 可 ， 如 图 6-90 所 示 。 


搜索 条 件 : [用户 v| MSEE [test | A) (eRe 
[ORAA | 夏 制 到 新 用 户 ] | (ER) | RRR |e ][ 生 成 新 密码 ] EE] 
nishem like Bee aire 以 UME 导入 格式 显示 用 户 数据 以 导入 到 其 它 系 统 


288 


6-90 导 ! 


1 用 户 信 息 的 操作 界面 


8) 随后 会 出 现 对 应 用 户 的 脚本 信息 ， 不 过 并 不 会 包含 用 户 的 密码 信息 ， 如 图 6-91 
所 示 。 


6.3.3 ”用户 管理 API 开发 zi 
SAP 提供 了 一 系列 用 户 管理 的 API， 通 过 UME 的 API 可 Se 
以 完成 绝 大 部 分 的 用 户 管理 功能 ， 包 括 新 建 组 、 角 色 或 用 户 人 


等 ， 同 时 也 可 以 实现 对 组 添加 角色 ， 给 指定 用 户 分 配角 色 等 CES 
操作 。 对 于 较为 复杂 、 特 殊 的 用 户 需求 ， 可 以 考虑 通过 APL OO! TONERA 
自 定 义 用 户 管理 ， 这 样 会 更 加 灵活 。 

1. 账号 管理 

1) 新 建 一 个 用 于 测试 的 Web Dynpro MEH, Æ DI 透视 图 中 手动 添加 对 “te/je/userman- 
agement/api” 开 发 组 件 的 依赖 ， 如 图 6-92 所 示 。 

2) 在 Web Dynpro 视图 中 添加 对 应 的 “新 增 用 户 ” 按 钮 ， 如 图 6-93 所 示 。 


i Da tc/ail/base/offline/facade: 
i i et 
Da tc/bl/logging/api 
Da tc/cmi 
Da tc/ddic/runtime/facade 
Da tc/je/usermanagement/api 
Da tc/wd/api 


图 6-92 需要 依赖 的 开发 组 件 清单 图 6-93 运行 效果 
3) 在 Java 编辑 需 中 添加 按钮 事件 的 处 理 逻 辑 ; 


final [UserFactory userFactory = UMFactory. getUserFactory( ) ; 
final [UserAccountFactory userAccountFactory = UMFactory 
. getUserAccountFactory () ; 


try | 
// create UserMaint 包含 用 户 个 人 信息 
String accountNo = " test04" ; // 账 号 


IUserMaint userMaint = userFactory. newUser( accountNo) ; 
userMaint. setDisplayName( " test04" ) ; 


userMaint. setFirstName( "04" ) ; WY 
userMaint. setLastName( " test" ) ; // 姓 
userMaint. setPersonID( "0004" ) ; pif Me 
userMaint. setCompany("SAPEYES" ) ; 公司 


userMaint. setEmail( "test04@ sapeyes. com" ) ; // 邮 箱 

// create UserAccount 包含 账号 认证 信息 

IUserAccount userAccount = userAccountFactory 

. newUserAccount( accountNo); 

userAccount. setLocked (false, 0) ; // 默 认 不 锁定 

userAccount. setSecurityPolicy( IUserAccount. SECURITY_POLICY_TYPE_TECHNICAL) ; 
// 用 户 安全 策略 为 技术 用 户 

userAccount. setPassword( " 1234qwer" ) ; // 设 置 技术 用 户 的 密码 

// Write the changes to the user store 提交 用 户 的 创建 

userFactory. commitUser(userMaint, userAccount) ; 

} catch (UMException e) | 

logger. errorT (" 新 增 UME 用 户 数据 失败 :" +e. getMessage() ) ; 

| 
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4) 在 视图 中 再 添加 一 个 “删除 用 户 ” 的 按钮 ， 如 图 6-94 所 示 。 
5) 在 Java 编辑 带 中 添加 按钮 事件 的 处 理 逻 辑 : 


final [UserFactory userFactory = UMFactory. getUserFactory( ) ; 
final IUserAccountFactory userAccountFactory = UMFactory 
. getUserAccountFactory( ) ; 


try | 

String accountNo =" test04" ; // 账 号 

userFactory. deleteUser( userFactory. getUserByLogonID ( accountNo) 
. getUniqueID( ) ) ; // 删 除 账 号 


} catch (UMException e) | 

logger. errorT (" 删除 UME 用 户 数据 失败 ." +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 

"删除 UME 用 户 数据 失败 :" +e. getMessage() ) ; 

| 


6) 在 视图 中 再 添加 一 个 “查询 用 户 ” 按 钮 ， 如 图 6-95 所 示 。 


BEES | HERES SHEP | HEF | 查询 用 产 


图 6-94 运行 效果 1 图 6-95 运行 效果 2 


7) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 ; 


IUserFactory userFact = UMFactory. getUserFactory() ; 

IUser user; 

try | 

user = userF act. getUserByLogonID(" test04" ) ; 

if (user ! = null) | 

String approver = user. getUniqueID( ) ; 

wdComponentAPI. getMessageManager( ). reportSuccess( 
"Uniqueld;" + approver) ; 

| else | 

wdComponentAPI. getMessageManager( ). reportException(" 不 存在 的 用 户 1" ) ; 
| 

} catch (Exception e) | 

logger. errorT ("UME 读 取 用 户 数 据 异 常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 

"UME 读 取 用 户 数 据 异常 ." +e. getMessage( ) ) ; 

| 


8) 完成 开发 后 ， 保 存 所 有 修改 ， 编 译 并 部 署 应 用 程序 即 可 进行 功能 测试 ， 如 图 6-96 
所 示 。 
9) 单 击 “ 查 询 用 户 ” 按 钮 ， 读 取 用 户 失 败 并 抛 异常 ， 如 图 6-97 所 示 。 


HEAR || 师 除 用 户 || HAAA 


| @ uME 访 取 用 户 数据 异常 -USER AUTH_FAILED: User account for logonid “test04" not found! 


图 6-96 运行 效果 3 图 6-97 提醒 消息 


10) 单 击 “ 新 增 用 户 ”按钮 后 ， 再 次 单 击 “查询 用 户 ” 按 钮 ， 打 印 新 增 用 户 的 唯一 标 
识 ， 表 示 创 建 用 户 成 功 ， 如 图 6-98 所 示 。 

11) 使 用 管理 员 登 录 系 统 后 ， 可 以 在 UME 用 户 信 息 中 看 到 具体 的 用 户 ， 如 图 6-99 
所 示 。 
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登录 标识 : test04 
姓氏 : test 
zt: 04 
BF a éh: test04@sapeyes.com 
Hi: 
语言 : 
šaman% O 
安全 策 路 : REA 
[Ø Uniquela:USER PRIVATE_DATASOURCE unttest04 PIs I UCU SUES TT 


Al 6-98 成 功 创建 的 消息 图 6-99 用户 详 细 信 息 


12) 单 击 “ 删 除 用 户 ” 按 钮 后 ， 再 次 单 击 “查询 用 户 ” 按 钮 ， 再 次 抛 出 异常 ， 标 识 删 
除 成 功 ， 如 图 6-100 所 示 。 

2. 角色 管理 

1) 继续 使 用 之 前 的 Web Dynpro mA, 在 视图 中 添加 一 个 “新 增 角 色 ” 按 钮 ， 如 
图 6-101 所 示 。 


加 UME 读 取 用 户 数据 异常 :USER_AUTH_FAILED: User account for logonid test04" not found! 
vl 
图 6-100 ”提醒 消息 


2) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 ; 


IRoleFactory roleFactory = UMFactory. getRoleFactory( ) ; 

try | 

IRole newRole = roleFactory. newRole(" ROLEO2" ) ; 

newRole. setDisplayName(" ROLE02" ) ; 

newRole. commit( ) ; 

| catch (Exception e) | 

logger. errorT(" UME 新 增 角 色 数 据 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 

"UME 新 增 角 色 数 据 异 常 :" +e. getMessage() ) ; 

| 


3) 在 视图 中 添加 一 个 “删除 角色 ”按钮 ， 如 图 6-102 所 示 。 
4) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 : 


IRoleFactory roleFactory = UMFactory. getRoleFactory( ) ; 

try | 

roleFactory. deleteRole(roleFactory. getRoleByUniqueName(" ROLEO2" ) 
. getUniqueID() ) ; 

| catch (Exception e) | 

logger. errorT(" UME 删除 角色 数据 异常 :" +e. getMessage()) ; 
wdComponentAPI. getMessageManager( ). reportException( 

"UME 删除 角色 数据 异常 :" +e. getMessage( ) ) ; 

| 


5) 在 视图 中 添加 一 个 “查询 角色 ”按钮 ， 如 图 6-103 所 示 。 


HAAF | HERA | SORA | HPAES | HERE | SHEP || PERF | SORA | FEAE | SSE | SARE 
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6) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 : 


IRoleFactory roleFactory = UMFactory. getRoleFactory( ) ; 


IUser user; 

try | 

IRole roleByUniqueName = roleFactory. getRoleByUniqueName(" ROLEO2" ) ; 
if (roleByUniqueName ! = null) | 


String role = roleByUniqueName. getUniqueID( ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess ( 
"Uniqueld:" + role) ; 

| else | 

wdComponentAPI. getMessageManager( ). reportException(" 不 存在 的 角色 1" ); 
| 

} catch (Exception e) | 

logger. errorT ("UME 读 取 角色 数据 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( pace pion 

"UME 读 取 角色 数据 异常 :" +e. getMessage( ) ) ; 

| 


7) 在 视图 中 添加 一 个 “添加 用 户 到 角色 ”按钮 ， 如 图 6-104 所 示 。 
8) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 . 


IRoleFactory roleFactory = UMFactory. getRoleFactory( ) ; 


try | 

// 根 据 用 户 的 唯一 ID 添加 用 户 到 角色 roleFactory. addUserToRole( UMFactory. getUserFactory( ) 
. getUserByLogonID( "test04" ) 

. getUniqueID() , roleFactory. getRoleByUniqueName( " ROLE02" ). getUniqueID() ) ; 

} catch (Exception e) | 

logger. errorT(" UME 添加 用 户 到 角色 异常 :" +e. getMessage() ) ; 

wdComponentAPI. getMessageManager( ) . E 

"UME 添加 用 户 到 角色 异常 :" +e. getMessage( ) ) ; 

| 


9) 完成 开发 后 ， 保 存 所 有 修改 ， 编 译 并 部 署 应 用 程序 即 可 进行 功能 测试 ， 如 图 6-105 
所 示 。 


新 增 用 户 | WAA || SBR || 新 增 角 色 | WAE | 查询 角色 snag | 


SHEP | MEERA | SHA | SRE | MERE | SHE | SPAA HRE 


4 


图 6-104 ”运行 效果 7 图 6-105 ”运行 效果 8 


10) 单 击 “查询 角色 ”按钮 ， 读 取 角 色 失 败 并 抛 出 异常 信息 ， 如 图 6-106 所 示 。 
11) 单 击 “ 新 增 角 色 ” 按 钮 后 ， 再 次 单 击 “查询 角色 ”按钮 ， 打 印 新 增 角色 的 唯一 标 
WR, 表示 创建 角色 成 功 ， 如 图 6-107 所 示 。 


Q UME 读 取 角 色 数 据 异 常 :Role with uniqueName ROLE02 not found! A Uniqueld:ROLE.UME_ROLE_PERSISTENCE.un:ROLE02 
图 6-106 提示 消息 1 图 6-107 提示 消息 2 
12) 使 用 管理 员 登 录 系 统 后 ， 可 以 在 UME 用 户 信息 中 看 到 具体 的 用 户 ， 如 图 6-108 
所 示 。 


13) 单 击 “ 删 除 角 色 ” 按 钮 后 ， 再 次 单 击 “查询 角色 ”按钮 ， 再 次 抛 出 异常 ， 表 示 删 
除 成 功 ， 如 图 6-109 所 示 。 
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唯一 名 称 : ROLE02 
显示 名 称 : ROLE02 


位 置 : 
描述 : 
一 标识 : ROLE.UME_ROLE_PERSISTENCE.un:ROLE02 
唯一 标识 E 7 Q UME 读 取 角 色 数 据 异常 :Role with uniqueName ROLE02 not found! 


图 6-108 角色 的 详细 信息 图 6-109 提示 消息 


14) 单 击 “添加 用 户 到 角色 ”按钮 ， 随 后 使 用 管理 员 登 录 系 统 后 ， 可 以 在 UME 角色 信 
息 中 看 到 已 分 配 的 用 户 ， 如 图 6-110 所 示 。 


已 分 配 的 用 户 

ERAP MA Deea iT] 

主体 类 型 ' 登录 标识 = 名称 
â test04 test04 


图 6-110 已 分 配 的 用 户 
3. 用 户 组 管理 


1) 继续 使 用 之 前 的 Web Dynpro KIA, 在 视图 中 添加 一 个 “新 增 组 ”按钮 ， 如 
Al 6-111 所 示 。 


SHAS || MERA | SORA | FEAE | SAE | SARE | SHEF HAE | HES 


6-111 运行 效果 9 


2) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 : 


IGroupFactory groupFactory = UMFactory. getGroupFactory( ) ; 
try | 

IGroup newGroup = groupFactory. newGroup( " GROUPO02" ) ; 
newGroup. setDisplayName(" ROLE02" ) ; 

newGroup. commit( ) ; 

| catch (Exception e) | 

logger. errorT("UME 新 增 组 数据 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 
"UME 新 增 组 数据 异常 ." +e. getMessage( ) ) ; 

| 


3) 在 视图 中 添加 一 个 “删除 组 ”按钮 ， 如 图 6-112 所 示 。 


一 二 五 


FERF | MERA | SORA | SHAE | WERE | SARE | SHEPHAE | HHS | Hes 


Al6-112 ”运行 效果 10 


4) 在 Java 编辑 带 中 添加 按钮 事件 的 处 理 逻 辑 ; 


IGroupFactory groupFactory = UMFactory. getGroupFactory( ) ; 

try | 

groupFactory. deleteGroup ( groupFactory. getGroupBy UniqueName ( 
"GROUPO02" ). getUniqueID( ) ) ; 

} catch (Exception e) | 
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logger. errorT(" UME 删除 组 数据 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 
"UME 删除 组 数据 异常 :" +e. getMessage() ) ; 

| 


5) 在 视图 中 添加 一 个 “查询 组 ”按钮 ， 如 图 6-113 所 示 。 


EE | Hee] | ZARF | FERE | MERE | SORE | SHEHDSE | Hea | ARA |248] 


图 6-113 运行 效果 11 


6) 在 Java 编辑 器 中 添加 按钮 事件 的 处 理 逻 辑 : 


IGroupFactory groupFactory = UMFactory. getCroupFactory( ) ; 


try | 
IGroup groupByUniqueName = groupFactory. getGroupByUniqueName('" GROUPO2" ) ; 
if (groupByUniqueName ! = null) | 


String group = groupByUniqueName. getUniqueID( ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess ( 
"Uniqueld;" + group) ; 

| else | 

wdComponentAPI. getMessageManager( ). reportException( "不 存在 的 组 1" ) ; 
| 

} catch (Exception e) | 

logger. errorT(" UME 读 取 组 数据 异常 ." +e. getMessage( ) ) ; 
wdComponentAPI. getMessageManager( ). reportException( 
"UME 读 取 组 数据 异常 :" +e. getMessage() ) ; 

| 


7) 在 视图 中 添加 一 个 “添加 角色 到 组 ”按钮 ， 如 图 6-114 所 示 。 


ARAF || MRF | SHRP 


8) 在 Java 编辑 带 中 添加 按钮 事件 的 处 理 逻 辑 : 


IRoleFactory roleFactory = UMFactory. getRoleFactory( ) ; 

try | 

// 通 过 角色 的 Uniqueld 添加 角色 到 组 

roleFactory. addGroupToRole( UMFactory. getGroupFactory( ) 

. getGroupByUniqueName("GROUP02" ). getUniqueID( ), UMFactory 
. getRoleFactory( ). getRoleByUniqueName( " ROLEO2" ) 

. getUniqueID() ) ; 

} catch (Exception e) | 

logger. errorT ("UME 添加 角色 到 组 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ). reportException( 

"UME 添加 角色 到 组 异常 :" +e. getMessage() ) ; 

| 


9) 在 视图 中 添加 一 个 “添加 用 户 到 组 ”按钮 ， 如 图 6-115 所 示 。 
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添加 用 户 到 角色 | 新 增 组 || WR | BREA || ORMARE | 添加 用 户 到 组 


EARE 


新 增 用 户 | MRSA | 查询 用 户 | 新 增 角 色 | WRAS || 


到 6-115 运行 效果 13 


10) 在 Java 编辑 咒 中 添加 按钮 事件 的 处 理 逻 辑 : 


IGroupFactory groupFactory = UMFactory. getGroupFactory( ) ; 


try | 

// 通 过 用 户 的 Uniqueld 添加 用 户 到 组 

groupFactory. addUserToGroup( UMFactory. getUserFactory ( ) 

. getUserBy UniqueName(" test04" ). getUniqueID() , UMFactory 
. getCroupFactory( ). getGroupByUniqueName(" GROUPO2" ) 

. getUniqueID() ) ; 

} catch (Exception e) | 

logger. errorT(" UME 添加 用 户 到 组 异常 :" +e. getMessage() ) ; 
wdComponentAPI. getMessageManager( ) reponttcception( 

"UME 添加 用 户 到 组 异常 :" +e. getMessage() ) ; 


| 


11) 完成 开发 后 ， 保 存 所 有 修改 ， 编 译 并 部 署 应 用 程序 即 可 进行 功能 测试 。 
12) 单 击 “查询 组 ” 按钮 ， 读 取 组 失败 并 抛 出 异常 ， 如 图 6-116 所 示 。 
13) 单 击 “ 新 增 组 ”按钮 后 ， 再 次 单 击 “ 查 询 组 ”按钮 ， 打 印 新 增 组 的 唯一 标识 ， 标 


识 创建 组 成 功 ， 如 图 6-117 所 示 。 


Q UME 读 取 组 数据 异常 :Group "GROUP02" does not exist. [A Uniqueld:GRUP.PRIVATE_DATASOURCE.un:GROUP02 


图 6-116 提示 消息 1 图 6-117 提示 消息 2 


14) 使 用 管理 员 登 录 系统 后 ， 可 以 在 UME 用 户 信息 中 看 到 具体 的 组 信息 ， 如 图 6-118 


所 示 。 
15) 单 击 “ 添 加 角色 到 组 ”按钮 ， 随 后 使 用 管理 员 登 录 系 统 后 ， 可 以 在 UME 角色 信息 


中 看 到 已 分 配 的 角色 ， 如 图 6-119 所 示 。 


已 分 配 的 角色 
搜索 条 件 : MER ~] (Dise 
唯一 名 称 : GROUP02 主体 类 型 名 称 = | 描述 
显示 名 称 : ROLE02 D ROLE02 
Hi: 
唯一 标识 : GRUP.PRIVATE_DATASOURCE.un:GROUP02 
到 6-118 组 的 详细 信息 图 6-119 查询 已 分 配 的 角色 


16) 单 击 “添加 用 户 到 组 ”按钮 ， 使 用 管理 员 登 录 系 统 后 ， 可 以 在 UME 角色 信息 中 看 
到 已 分 配 的 用 户 “test04”， 如 图 6-120 所 示 。 


已 分 配 的 用 户 

搜索 条 件 : [所 有 于 所 Cee aT] 

主体 类 型 登录 标识 = Bi 
â test04 test04 


图 6-120 查看 已 分 配 的 用 户 
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64 系统 管理 


SAP 企业 门户 的 系统 管理 是 针对 门户 系统 进行 参数 、 服 务 配置 ， 包 括 系 统 配 置 、 传 送 、 监 
控 、 许 可 、 系 统 前 景 、 联 合 门 户 、 支 持 和 内 容 统计 等 内 容 。 门 户 中 的 系统 管理 与 SAP NetWeav- 
er 的 NWA 管理 者 平台 是 有 区 别 的 ， 前 者 是 针对 门户 系统 的 系统 配置 ， 而 后 者 更 多 的 是 为 
NetWeaver 平台 服务 ， 也 就 是 服务 器 端的 配置 。 从 某 种 意义 来 说 ,门户 系统 其 实 也 只 是 
NetWeaver 平台 上 的 一 个 复杂 应 用 ， 如 图 6-121 所 示 。 


— — y >; 
E E 
内 容 管理 用 户 管理 系统 管理 
FARR fe | 监控 | 许可 | 系统 前 景 | 联合 门户 | 支持 | 内 容 统计 
系统 管理 > 系统 配置 > UME 配置 
Ca ma 
HODET [EARE] | 保存 所 有 更 改 | 恢复 已 保存 的 设置 | 
> 内 容 模型 管理 
A 数据 源 RSH 通知 电子 邮件 用 户 映射 “用 户 管理 U 


”缓存 管理 


> 运行 时 设置 数据 源 RERE 

。 提 供 者 配置 数据 源 文 件 名 称 : |dataSourceConfiguration_database_only xml 
> 知识 管理 > 

+ 协作 


Kl 6-121 UME 配置 界面 


由 于 篇 幅 有 限 ， 无 法 在 章节 中 对 系统 配置 的 各 个 功能 点 进行 说 明 ， 本 节 重 点 介绍 与 
Web Dynpro 开发 应 用 相关 的 一 些 配置 点 。 
6.4.1 UME 配置 


UME 配置 中 包含 了 数据 源 、 安 全 策略 、 通 知 电子 邮件 、 用 户 映射 、 用 户 管理 UI 等 内 容 ， 
窗 盖 了 从 用 户 登录 、 后 台 用 户 数 据 源 配 置 到 第 三 方 系统 映射 等 功能 ， 如 图 6-122 所 示 。 


ARER > FARE > MERNE Sean ~ 
RE 
Tea | 
MBER kern era A | 用户 管 理 册 | OCC) 
数据 源 DIRE 
数据 源 文 件 名 称 : dataSourceConfiguration_database_only.xml 


图 6-122 UME 配置 的 详细 界面 


1. 数据 源 配置 
配置 修改 UME 的 数据 源 ， 可 以 修改 UME 数据 源 的 连接 参数 和 连接 类 型 ， 即 修改 UME 


后 台数 据 库 对 象 。 黑 认 情 况 下 ，UME 的 数据 源 仅 使 用 NetWeaver 环境 安装 时 指定 的 数据 库 ， 
即 在 视图 中 “数据 源 ” 属 性 会 显示 “ 仅 数 据 库 ”, 但 由 于 企业 的 信息 系统 往往 会 涵盖 较 多 不 
同 语言 、 不 同 架 构 的 子 系统 ， 并 且 系 统 间 采用 统一 的 用 户 管理 ,使 用 相同 的 用 户主 数据 ， 如 
果 每 个 子 系统 都 建立 一 套 独立 的 用 户 存储 空间 ， 会 带 来 数据 同步 、 数 据 访问 不 一 致 等 诸多 次 
端 ， 因 此 为 了 减少 因 多 数据 存储 带 来 的 系统 间 用 户主 数据 不 一 致 或 用 户 同步 所 带 来 的 工作 
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i=} 


量 ， 项 目 中 会 通过 修改 前 台 EP 的 用 户 数据 源 ， 直 接 实现 统一 用 户 数据 源 的 目的 。 
数据 源 配置 实例 : 
1) 单 击 视 图 中 的 “修改 配置 ”按钮 ， 就 可 以 通过 下 列 列 表 对 UME 支持 的 数据 源 类 型 
进行 选择 ， 同 时 下 方 多 了 一 个 数据 源 配置 文件 的 “上 载 控 件 ” 按 钮 ， 如 图 6-123 所 示 。 


配置 
[EREE | | [ 保存 所 有 更 改 | | 恢 夏 已 保存 的 设置 ] 打开 专家 模式 ] 
数据 源 | 安全 策略 通知 电子 邮件 用 户 映射 用 户 管理 山 四 日 
数据 源 [TRENT X 


数据 源 文件 名 称 : |dataSourceConfiguration_database_only.xml 
Eber; 


xS: L ae] 
ESZE 


图 6-123 ”修改 数据 源 


2) 单 击 “数据 源 ” 右 侧 的 下 拉 按 钮 ， 就 能 看 到 所 有 支持 的 类 型 ， 包 括 很 多 知名 企业 的 
LDAP 产品 ， 以 及 SAP 的 ABAP 系统 ， 如 图 6-124 所 示 。 
3) 接着 选择 ABAP 系统 连接 测试 环境 进行 演示 ， 如 图 6-125 所 示 。 


{RENTER M 
dataSourceConfiguration_a1s.xml a 
ABAP 系统 

Microsoft ADS 只 读 【 深 度 层 次 结构 ) + 数据 库 

Microsoft ADS 《深度 层次 结构 ) + 数据 库 数据 源 : [ABAP 系统 [7] 
Microsoft ADS 只 读 (平面 层次 结构 ) -+ 数据库 
Microsoft ADS 平面 层次 结构 ) + 数据 库 

| 促 数 据 库 

| sun ONE LOAP 服务 器 〈 深 度 层次 结构 ) + SURE 


数据 源 文件 和 名称 : |dataSourceConfiguration_abap xml 


下 载 文件 


i ER: we... 
Sun ONE LDAP 服务 器 只 读 〈 深 度 层次 结构 ) + 数据 库 [ERR] 
Sun ONE LOAP 服务 器 【平面 层次 结构 ) + 数据 库 


器 


6-124 ”数据 源 支 持 的 不 同类 型 


N 


6-125 ”修改 为 ABAP 系统 数据 源 


其 中 “数据 源 文件 名 称 ” 会 自动 切换 对 应 的 配置 文件 ， 如 果 需 要 进行 自 定 义 ， 则 可 以 
通过 单 击 “ 上 载 文件 ”进行 替换 。 

4) 在 选择 “ABAP 系统 ”后 ， 上 方 配 置 页 签 也 会 多 出 一 栏 “ABAP 系统 ”， 单 击 该 页 
签 ， 创 建 并 维护 RFC 目标 ， 目 标 指 定 ABAP 系统 的 连接 信息 ， 确 认 配 置 连接 成 功 ， 如 
Al 6-126 所 示 。 

这 里 的 RFC 目标 其 实 就 是 在 Web Dynpro 开发 中 使 用 REC 模型 时 配置 的 逻辑 目标 ， 同 样 
地 用 于 两 个 系统 之 间 的 连接 。 完 成 配置 后 ， 单 击 “ 保 存 ” 按 钮 ， 并 重启 服务 器 实例 。 

注 : 修改 数据 源 需 要 慎重 ， 建 议 在 备份 必要 用 户 数据 后 进行 。 

5) 接着 进入 用 户 管理 页 面 ， 查 询 ABAP 系统 中 的 用 户 ， 如 图 6-127 所 示 。 


RE ABAP Ri | HSK | BNATH | 


AURE 


UME RFC 目标 
UME RFC 目标 : [MT_RFC_EPD_META_DEST| 
更 改 的 UME RFC 目标 : [MT_RFC_EPD_META_DEST 


-RFC_EPD_ 搜索 条 件 : [EF |w|[ABAP ”|w|| 帮 | 27) (Baez 


图 6-126 ABAP 系统 目标 配置 6-127 搜索 用 户 界面 
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6) 可 以 看 到 搜索 结果 的 用 户 清单 中 , “数据 源 ” 一 列 显示 的 是 “ABAP”， 也 就 表示 这 
些 用 户 来 自 于 ABAP 系统 ， 如 图 6-128 所 示 。 


部 门 RE 
开发 ABAP 
开发 ABAP 
开发 ABAP 
开发 ABAP 


四 


6-128 查询 用 户 清单 的 数据 源 


注 : 切换 数据 源 只 是 省 略 了 创建 用 户 的 动作 ， 企业 门户 中 的 角色 分 配 仍然 需要 具体 
配置 。 

2. 其 他 参数 配置 

1) 安全 策略 : 用 户 登 录 的 安全 验证 方式 ， 包 括 默 认 与 技术 用 户 ， 也 可 以 自 定义 新 的 安 
全 策略 。UME 中 新 建 用 户 的 属性 中 也 包含 安全 策略 。 可 以 修改 默认 的 安全 策略 ， 如 登录 标 
识 长 度 、 蜜 码 长 度 等 ， 如 图 6-129 所 示 。 

2) 登录 标识 相关 的 安全 策略 设置 ， 如 图 6-130 所 示 。 


效 据 滨 A RARE | ”过 知 电子 邮件 | 用 / 
安全 策 路 参数 文件 
R 2h = 
BET 与 登录 标识 相关 的 局 性 
Spee 登录 标识 的 最 小 长 度 : 1 
登录 标识 的 县 大 长 度 : 20 
营 示 标识 中 数字 的 最 小 区 0 
= L EBRRREHSREE She: [0 
创建 | He | 芝 示 标识 中 小 瑟 闻 母 的 最 小 数目 : [0 


图 6-129 安全 策略 配置 图 6-130 登录 标识 相关 配置 


3) 密码 相关 的 安全 策略 设置 ， 如 图 6-131 所 示 。 
4) 锁定 相关 的 安全 策略 设置 ， 如 图 6-132 所 示 。 


二 密码 相关 的 属性 
民 码 的 县 小 长 度 : 5 
褒 码 的 旭 大 长 度 : [14 
Enta Righi 0 
Eutreta [1 
eai hae 0 
EB RRTERAK: 0 
不 允许 的 口令 : 
座 码 最 长 空闲 时 间 : 0 
ESSER (RR : 90 


口 允许 登录 标识 作为 部 分 密码 
O 允许 巨 密码 作为 部 分 新 密码 与 用 户 账户 锁定 相关 的 属性 


V 允许 诈 户 更 改 自 有 密码 MERA RAR: 6 
口 增强 登录 时 的 密码 案例 策 路 自动 解 然 时 间 《 分 钟 数 ) : 60 


图 6-131 密码 相关 的 安全 策略 设置 图 6-132 锁定 相关 的 安全 策略 设置 
通过 修改 这 些 参 数 ， 改 变 登 录 标识 、 密 码 修改 复杂 度 、 用 户 过 期 时 间 等 。 技 术 用 户 是 针 


对 系统 间 通 信 而 设置 的 后 台 验 证 策略 ， 用 户 的 安全 策略 为 技术 用 户 时 ,不 需要 修改 初始 密 
码 ， 而 且 密 码 没有 过 期 时 间 。 
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5) 用 户 管理 UI: 控制 用 户 管理 界面 的 搜索 结果 显示 ， 如 果 人 允许 的 搜索 结果 过 大 ， 则 会 
影响 服务 器 在 用 户 管理 搜索 时 的 效率 ， 如 图 6-133 所 示 。 
6) 登录 帮助 ， 以 及 是 否 需 要 开启 安全 问题 策略 ， 如 图 6-134 所 示 。 


BESRFLRR 
搜索 结果 的 最 大 效 : 1000 
ABESSHSSEFE: 200 
Logon Help 

SARTRE NTR: 20 Dsaeeenwens 
中 等 王 示 才 中 的 行 数 : 10 使 用 预定 义 的 去 全 问题 
ENIRA 5 HE pE 

图 6-133 ”搜索 界面 的 配置 图 6-134 登录 帮助 相关 配置 


6.4.2 ”内容 传输 


由 于 SAP 企业 门户 的 内 容 变 更 并 没有 ERP 系统 或 Web Dynpro 开发 那么 频繁 ， 大 部 分 的 
变更 在 项 目 上 线 前 都 已 完成 ， 因 此 门户 内 容 在 不 同系 统 之 间 的 传输 是 以 传输 包 的 形式 进行 
的 ， 从 而 减少 了 生产 传输 的 配置 工作 量 ， 如 图 6-135 所 示 。 

1. 传输 包 导 出 ZANA 传送 监控 

在 系统 管理 的 “传送 ”页 面 ， 可 以 看 到 与 企业 门户 内 容 管理 同样 
的 菜单 ， 但 唯一 的 区 别 是 ， 只 有 在 系统 管理 的 “传送 ”菜单 下 ,才能 
看 到 自 定义 配置 的 传输 包 内 容 。 

1) 首先 ,创建 一 个 传输 包 的 存放 文件 夹 ， 右 击 “ 门 户 内 容 ”， 选 图 6-135 门户 内 容 
择 新 建文 件 夹 ， 然 后 输入 对 象 名 称 、 对 象 标识 和 文件 夹 ID Prefix, WE 传输 的 菜单 
6-136 所 示 。 

2) 完成 后 , 文件 夹 与 内 容 管理 中 进行 测试 的 目录 “项 目 内 容 ” 并 列 ， 如 图 6-137 
所 示 。 

3) 右 击 “项 目 内 容 传输 包 ”， 选 择 “ 新 建 ” 一 “传输 包 ”， 在 文件 夹 中 创建 传输 包 ， 
如 图 6-138 所 示 。 


对 象 名 称 : * aie 
EEEE .1 moun ii 
MRR (REHM. URBRFRAD : ae 
L___ RS 
ZA ID Prefix (Example: com.companyname): = 
m.myproject 分 析 
see > (BAS 
[ex 同 ， 门 项 目 兴 容 传输 包 By 
图 6-136 输入 对 象 信息 图 6-137 文件 夹 目录 图 6-138 ”操作 菜单 


4) 输入 对 象 名 称 、 对 象 标识 和 传输 包 ID Prefix， 完 成 传送 包 的 创建 ， 如 图 6-139 所 示 。 

5) 创建 成 功 后 ， 可 以 在 文件 夹 中 看 到 一 个 包 右 图 标的 文件 ， 如 图 6-140 所 示 。 

6) 由 于 这 个 传输 包 仍 然 是 一 个 空 的 “箱子 ”， 因 此 需要 添加 内 容 。 右 击 “tspk_001”， 
并 选择 “打开 ”一 “ 包 内 容 ”， 如 图 6-141 所 示 。 

7) 在 打开 传送 包 后 ， 可 以 选中 需要 传输 的 内 容 进 行 添加 ， 这 个 过 程 与 添加 页 面 到 角色 
中 十 分 相似 。 右 击 “ 项 目 内 容 ” 文 件 夹 ， 选 择 “ 添 加 到 传送 包 ” 一 “所 有 对 象 " WRX 
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MRE: * 
tspk_0001 


对 象 标识 “要 自动 创建 标识 ， 


|com.myproject 


WRBAFRAD) : 


传送 包 ID Prefix (Example: com.companyname): 


图 6-142 所 示 。 


8) 添加 完成 后 ， 在 右 侧 的 “传送 包 内 


态 表 示 是 否 添 加 成 功 ， 如 图 6- 


图 6-139 ”输入 对 象 信息 


里 选择 “对 象 ”， 则 仅 会 添加 选中 的 文件 夹 对 象 ， 而 不 会 包含 所 
选 文件 夹 中 的 对 象 ， 所 以 一 般 都 会 选择 添加 “所 有 对 象 ”， 


图 


143 所 示 。 


Bry 


容 


an een 
ath | = 
X 项 目 尖 容 传 某所 By 和- 
aaa re fe 
6-140 创建 后 的 对 象 图 6-141 
深 加 到 传送 包 


操作 菜单 


可 对 和 
所 有 对 象 
作为 已 同步 文件 兴 


如 Ba 
图 


6-142 


操作 菜单 


中 就 能 看 到 添加 后 的 目录 清单 ， 最 右 侧 的 状 


传送 包 内 容 
ASRSHESHURSSSSSRAAS 
EJEA | ae en = 

匀称 
~ (nea 
~ ORES 
~ (ONMEW 
。 sess 
~ 门人 事 管理 
~ 45 
~ abe 

» Fase 

~ Qï 
。 R45 


标识 


pcd:portal_content/com.myproject.proj 
pcd:portal_content/com.myproject.projcom.myproject. VIEW 


pcd:portal_content/com.myproject.proj/com.myproject.IVIEW/com.myproject... 


pcd:portal_content/com.myproject.proj/com.myproject.f_hrmng 


pcd:portal_content/com.myproject.proj’com.myproject.f_hrmng/com.myproj. .. 
pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproj... 
pced:portal_content/com.myproject.proj/com.myproject.f_hrmng/com.myproj... 
pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproj. .. 
pcd:portal_content/com.myproject.proj/com.myproject.f_hrmng/com.myproj. .. 


4 S| < S/S) 8) <<< 


9) 接着 右 击 传送 包 ， 选 
“标准 导出 ”会 多 一 个 环节 ， 
果 是 一 样 。 


10) 在 右 侧 的 导出 向 导 中 ， 可 以 看 到 导出 传送 包 的 简单 信息 ， 确 认 无 误 后 


出 ”按钮 ， 如 图 6-145 所 示 。 


a4 “Een” 


图 6-143 ”传送 包 内 容 清单 


一 “快速 导出 ”， 
需要 进行 导出 内 容 的 确认 ， 可 以 根据 实际 情况 选择 ， 


如 图 6-144 所 示 。 这 


这 里 如 果 选 择 
导出 的 结 


Tr 


， 单 击 “ 导 


ik 


图 6-144 EXA 


11) 在 导出 过 程 中 ， 


[a =-# [$8 9] | [== le 
传送 明细 : 
传送 方法 : FileSystem 
文件 名: com.myproject.tspk_0001_20140213_084315.epa 
文件 目标 : /usr/sap/MPD/SY S/globalpcd/Export 
传送 包 属性 : 
导出 模式 所 让 效 据 类 型 
Bess: 已 包括 参考 
明确 参考 : 已 包括 参考 
已 过 滤 的 参考 com.myproject.* 
传送 包 内 容 : 
用 于 导出 的 项 27 
排除 的 项 : 0 
图 6-145 导出 向 导 


会 出 现 导 出 的 进度 条 ， 如 图 6-146 所 示 。 


ee ee 
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HEH 


吉 果 的 一 个 日 志 信 息 ， 如 图 6-147 所 示 。 
13) 也 可 以 看 到 导出 对 象 的 明细 清单 ， 如 图 6-148 所 示 。 


c= | [元 
导出 汇总 
文件 各: com.myproject.tspk_0001_20140213_084552.epa 要 导出 的 项 目 27 
0% aos p 7 i = 己 导 出 27 
取消 已 从 包 中 捧 队 0 
se 0 
iit +: RR ut a 
图 6-146 导出 进度 条 图 6-147 导出 日 志 
导出 的 对 象 
Erke|25 |v 
‘= 
m 类 型 PaK PRSS aa 状态 
P 
5} tspk_0001 55 pcd:portal_content/com.myproject.New_Folder/com.mypro... 确定 
© 国定 资产 维护 4 ped:portal_content/com.myproject.projcom.myproject.f_lo... $E 
[ist 国定 资产 维护 6 pcd:portal_content/com.myproject.projcom.myproject.f_lo... $E 
© 国定 资产 作 度 4 pcd:portal_content/com.myproject.proj/com.myproject. f_lo... 确定 
EA 国定 资产 作 记 6 ped:portal_content/com.myproject.projicom.myproject.f_lo... 确定 
A 后 勤 答 理 3 pcd:portal_content/com.myproject.projcom.myproject.f_lo... $E 
| 45 10 ped:portal_content/com.myproject.projicom.myproject.f_hr... 确定 
T] 45 5 ped:portal_content/com.myproject.projicom.myproject.f_hr... 确定 
© 考勤 4 ped:portal_content/com.myproject.projcom.myproject.f_hr... 确定 


6-148 ”导出 对 象 的 明细 清单 


14) 在 默认 情况 下 , 该 导出 向 导 是 将 生成 的 “. epa” 传 送 包 文件 导出 至 服务 器 端的 
“export” 目录 中 ,但 为 了 避免 频繁 地 进行 服务 器 登录 、 文 件 传 输 操作 ， 门 户 中 也 允许 用 户 
将 导出 文件 直接 下 载 至 本 地 计算 机 中 ， 方便 后 续 的 操作 ， 如 图 6-149 所 示 。 

2. 传输 包 导 入 

1) 以 管理 员 身 份 登录 传输 包 导 入 的 目标 系统 ， 打 开 “ 系 统管 理 ” 一 “传送 ”一 “ 导 
入 ”的 页 面 ,“ 包 文件 的 资源 ”选择 “客户 端 ”， 随 后 单 击 “ 浏 览 ”按钮 ， 选 择 并 上 载 本 地 
计算 机 中 的 传送 包 文 件 ， 如 图 6-150 所 示 。 


包 文件 的 资源 : OFAN CORSE 


文件 : |D:\com.myproject.tspk_0001_0330_024924.epa 


PARK 


导出 完成 于 200.0 BH 
ay Fax 


6-149 下 载 文件 链接 6-150 “导入 文件 选择 
2) 单 击 “ 上 载 ” 按 钮 ， 即 可 开始 上 载 的 动作 ， 如 图 6-151 所 示 。 


a 
on 


Th 


导入 预览 

标识 = ”位置 

com.myproject__ pcd:portal_content/com.myproject.projicom.myproject. VIEW 

com.myproject.Atten pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject.f_attend 

com.myproject.AttinApp pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject.f_attend/com.myproject.f_atteninp 


com.myproject.DepotMtApp | pcd:portal_content/com.myproject.proj/com.myproject. f_logiwork/com.myproject.f_wsop/com.myproject.f_depotmt 
com.myproject.f_attend pcd:portal_content/com.myproject.proj/com.myproject.f_hrmng 

com.myproject.f_atteninp pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject.f_attend 
com.myproject.f_attenquery pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject.f_attend 

com.myproject.f_depotmt pcd:portal_content/com.myproject.proj/com.myproject. f_logiwork/com.myproject.f_wsop 
com.myproject.f_fixassdel pcd:portal_content/com.myproject.proj/com.myproject. f_logiwork/com.myproject.f_pm 

com.myproject.f_fixassmt pcd:portal_content/com.myproject.proj/com.myproject. f_logiwork/com.myproject.f_pm 


Beogcdele Line 1/27 


图 6-151 导入 预览 


3) 导入 完成 后 ， 会 有 导 和 人 人 对象 的 一 个 明细 清单 ， 导 入 状态 也 会 显示 是 和 否 导 和 成功， 如 
图 6-152 所 示 。 
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FABER. 用时: 4 秒 . HR: 0. SE: 0. 


ESSERE EC ES 


开始 时 间 
14:55:06 
14:55:06 
14:55:06 
14:55:06 
14:55:06 
14:55:06 
14:55:06 
14:55:05 
14:55:05 
14:55:05 
14:55:05 
14:55:05 
14:55:05 
14:55:04 


导入 状态 的 细节 


状态 
确定 
BE 
确定 
RE 
确定 
RE 
确定 
确定 
确定 
确定 
确定 
确定 
确定 
确定 


标识 
com.myproject.f_wsop 
com.myproject.FixAssMtApp 
com.myproject.tspk_0001 
com.myproject.f_depotmt 
com.myproject. VReqApp 
com.myproject.f_atteninp 
com.myproject.f_fxassmt 
com.myproject. 
com.myproject.f_attend 
com.myproject.f_reqvac 
com.myproject.FixAssDel 
com.myproject.f_logiwork 
com.myproject.AttinApp 
com.myproject.f_fxassdel 


pcd:portal_content/com.myproject.proj/com.myproject.f_logiwork 

pcd:portal_content/com.myproject. proj’com.myproject. f_logiwork/com.myproject. f_pm/com.myproject. f_fixassmt 
pcd:portal_content/com.myproject.New_Folder 

pcd:portal_content/com.myproject. proj’com.myproject.f_logiwork/com.myproject.f_wsop 
pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject. f_reqvac/com.myproject.f_vacreq 
pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject.f_attend 
pcd:portal_content/com.myproject. proj’com.myproject. f_logiwork/com.myproject.f_pm 
pcd:portal_content/com.myproject.proj/com.myproject. VIEW 
pcd:portal_content/com.myproject.proj/com.myproject.f_hrmng 
pcd:portal_content/com.myproject.proj/com.myproject.f_hrmng 
pcd:portal_content/com.myproject.proj/com.myproject. f_logiwork/com.myproject.f_pmv/com.myproject.f_fixassdel 
pcd:portal_content/com.myproject.proj 

pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject. f_attend/com.myproject. f_atteninp 
ped:portal_content/com.myproject.projcom.myproject. f_logiwork/com.myproject.f_pm 


4) 接着 ,在 目标 系统 中 切换 至 内 容 管 理 
对 象 已 成 功 创建 ,传输 工作 完毕 ， 
注 : 如 果 是 Web Dynpro 页 面 的 传输 ， 除 了 门户 内 容 的 传输 之 
外 ，Web Dynpro 工程 仍然 需要 通过 开发 工具 或 者 NWDI 工作 将 程 


序 在 新 服务 器 中 进 和 


6. 4.3 


锁定 对 象 解锁 。 


进入 对 象 锁定 页 面 ， 可 以 看 到 锁定 管理 天 对 应 的 所 有 锁定 内 容 ， 


当 管理 员 在 编辑 门户 对 象 时 ， 清 单 中 就 会 
确 地 退出 或 其 他 原因 造成 的 


条 部 署 ， 这 样 才 能 正常 运行 。 


在 系统 监控 中 ， 主 要 是 处 理 门户 内 容 的 锁定 。 因 为 门户 配置 时 ， 
辑 的 对 象 自动 锁定 ,通过 此 处 可 以 查看 所 有 处 在 锁定 模式 中 的 对 象 ， 并 对 处 于 保护 时 间 内 的 


WR] 


6-152 ”导入 状态 明细 


就 能 看 到 所 有 传输 
如 图 6-153 所 示 。 


> (eae 
> 站 设备 


搜索 标准 


可 用 的 锁定 管理 右 : | com.sap.portal.pcd X 
所 有 锁定 的 对 象 z] 


异常 退出 ， 


Z 


6-154 ”搜索 锁定 对 象 


定 对 象 ， 则 选中 并 单 击 “ 解 锁 ” 按 钮 即 可 ， 如 图 6-155 所 示 。 


com.myproject.AttinApp | pcd:portal_content/com.myproject.proj/com.myproject. f_hrmng/com.myproject. f_attend/com.myproject.f_atteninp 
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6-155 解锁 对 象 操 作 界面 


6-153 ”导入 后 的 效果 


对 打开 或 正在 编 


如 图 6-154 所 示 。 


出 现 对 应 的 锁定 内 容 。 由 于 用 户 在 操作 时 不 正 
都 会 使 编辑 对 象 始终 处 于 锁定 状态 。 如 果 需 要 解锁 指 


577% SAP 业务 流程 管理 


业务 流程 管理 (Business Process Management，BPM) 这 一 概念 的 出 现 是 为 了 让 企业 能 在 
流程 自动 化 流转 的 基础 上 集中 化 地 处 理 业 务 ， 规 范 员工 的 业务 处 理 ， 并 提高 企业 的 运转 

目前 SAP 的 流程 管理 产品 有 以 下 3 种 : 一 种 是 运行 于 ERP 系统 中 的 工作 流 (workflow) , 
工作 流 基于 ABAP 语言 进行 开发 ， 而 且 已 深度 集成 在 ERP 系统 ， 因 此 与 ERP 的 逻辑 交互 具 
有 独到 的 优势 ， 但 是 同样 受 限 于 ERP 的 C/S 体系 架构 ， 在 集成 应 用 与 场景 运用 方面 ， 工 作 
流 并 不 能 满足 目前 日 益 增 多 的 轻 客户 端 浏览 需求 ， 而 且 对 于 一 些 公开 技术 的 支持 也 有 一 定 缺 
陷 ; 另外 一 种 是 流程 整合 系统 (SAP Process Integration, SAP PI) 的 流程 整合 工具 ， 集 成 在 
SAP PI 的 开发 平台 ， 主 要 用 于 多 系统 间 的 数据 流 整 合 和 管理 ， 还 有 一 种 就 是 NetWeaver 的 
BPM 业务 流程 管理 ， 以 用 户 为 核心 的 流程 主要 集中 在 高 度 交互 性 的 跨 组 织 、 跨 系统 的 流程 
类 型 ， 并 且 将 用 户 的 动作 与 后 台 服 务 进行 无 缝 地 连接 ， 同 时 它 运行 于 Java 架构 的 SAP 应 用 
服务 器 之 上 。 由 于 Java 语言 以 及 DEE 的 优势 ，SAP BPM 也 秉承 了 路 平台 、 可 移植 、 分 布 式 
等 特性 。 


7.1 BPM 系统 架构 


要 了 解 SAP BPM 之 前 ， 首 先 要 了 解 SAP NetWeaver 版 本 的 变化 ， 在 7.0 版 本 的 企业 门户 
中 ， 如 果 需 要 处 理 用 户 的 业务 流程 需求 ， 使 用 的 是 门户 中 的 向 导 流 程 (Guided Procedures, 
GP); 而 到 了 7. 1 版 本 ，SAP 首先 修改 了 门户 的 概念 ， 升 级 成 为 了 SAP 复合 环境 (Composite 
Environment，CE) ， 也 就 是 在 使 用 SAP BPM 时 经 常 能 听 到 的 “CE AS”; 接着 从 SAP 
NetWeaver CE 的 7. 1 版 本 提供 的 增强 包 1 (Enhancement Packagel, EHP1) 开始 ， 这 种 集成 
化 的 复合 环境 包含 了 流程 的 建 模 、 连 接 、 编 译 、 部 署 和 维护 复合 业务 流程 所 需要 的 功能 ， 也 
就 是 SAP NetWeaver 业务 流程 管理 (Business Process Management, BPM) 。 

SAP BPM 作为 SAP NetWeaver 平台 的 重要 组 成 部 分 ， 提 供 了 设计 、 业 务 流 程 建 模 、 实 
施 、 运 行 、 流 程 运行 监控 的 一 整套 工具 ， 和 帮助 SAP 的 客户 机 与 SAP 已 有 的 应 用 模块 实现 自 
动 化 的 业务 流程 流转 ， 跨 越 不 同 的 系统 来 控制 和 提升 业务 流程 的 运行 效率 ， 能 够 提高 流程 的 
整体 透明 度 ， 使 得 企业 的 复杂 的 业务 流程 能 够 高 效率 地 、 更 加 自动 化 和 更 加 智能 地 运行 。 男 
外 ，SAP BPM 还 能 降低 应 用 软件 的 开发 成 本 、 缩 短 上 市 时 间 、 加 强 法 规 遵从 的 贯彻 力度 、 
实现 业务 流程 性 能 的 最 优化 。 虽 然 BPM 系统 的 实施 并 不 会 大 幅 地 修改 原 有 业务 流程 ， 但 是 
与 关注 业务 流程 的 文档 和 流程 分 析 结 合 以 后 ，BPM 就 会 成 为 企业 改善 业务 效率 的 利器 。 在 
BPM 提供 的 高 级 开发 环境 中 ， 它 采用 流程 驱动 的 模型 和 性 能 评估 来 实现 IT 解决 方案 的 开 
发 。 当 然 ， 从 最 终 用 户 的 角度 来 看 ，BPM 工作 流 将 会 把 所 有 的 待 办 事项 都 主动 推送 给 用 户 ， 
用 户 只 需要 通过 浏览 器 登录 并 查看 门户 首页 的 待 办 事项 ， 单 击 打 开 即 可 处 理 ， 既 方便 了 用 户 
的 操作 ， 又 提升 了 工作 效率 。 

SAP BPM 的 流程 管理 主要 包含 了 以 下 3 个 模块 的 核心 功能 : 流程 设计 (Process Compos- 
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er) ， 集 成 在 SAP 的 开发 工作 室 中 ， 提 供 了 流程 
建 模 功能 ， 并 且 可 以 通过 图 形 化 的 设计 完成 流 
程 的 创建 和 配置 ;流程 桌面 (Process Desk) ， 集 
成 在 门户 中 ， 一 方面 通过 通用 工作 清单 对 BPM 
流程 待 办 进行 展示 ， 另 一 方面 使 用 Web Dynpro 
技术 开发 的 页 面 进行 具体 的 业务 操作 和 系统 间 的 
数据 传递 ; 流程 服务 器 (Process Server) ， 集 成 在 
NetWeaver 的 复合 环境 服务 器 中 ， 可 以 通过 NWA 
管理 者 平台 进行 管理 和 监控 。 流 程 管理 与 底层 的 
规则 设计 、 规 则 管理 以 及 规则 引擎 搭建 出 一 个 完 
整 的 SAP 业务 流程 管理 平台 ， 如 图 7-1 所 示 。 

凭借 这 些 功 能 和 架构 的 优势 ，BPM 已 经 逐 
HRN NetWeaver 平台 的 重要 管理 工具 ， 并 在 企 
业 信息 化 系统 的 系统 集成 、 流 程 整合 与 优化 中 
扮演 着 至 关 重 要 的 角色 。 


7.2 BPM 流程 设计 


规则 设计 nue 名 
+ 
规则 引擎 一 一 


图 7-1 业务 流程 管理 架构 图 


SAP BPM 的 流程 设计 包含 了 模型 设计 、 任 务 配置 、 流 程 参数 配置 以 及 启动 方式 配置 等 


几 个 方面 内 容 。 


7.2.1 模型 设计 


由 于 BPM 的 模型 设计 是 在 基于 Eclipse 的 开发 工具 中 直接 以 图 形 化 的 方式 来 进行 的 ， 
此 在 有 条 件 的 项 目 中 可 以 让 业务 人 员 直 接 参与 并 完成 流程 的 模型 设计 。 每 一 个 流程 中 都 包含 


BPM 流程 模型 的 所 有 组 成 要 素 : 事件 、 活 动 、 网 关 等 多 种 对 象 ， 如 图 7-2 所 示 。 当 然 每 一 
个 要 素 可 能 包含 了 各 种 不 同 的 子 要 素 ， 这 些 要 素 的 组 合成 为 复杂 流程 的 原型 。 


Invoxtment Approval Procom Supper 


| wrlT Eguia Provider | Purehaoe Aspemer Corporate Puroasaing 


Greve Cr | rue me 


irom -| hocerrsr 
Reopirenents | Lae a) 


7-2 将 草图 转换 为 BPM 流程 图 
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这 样 的 模型 设计 方式 包含 了 很 多 的 优点 : 流程 的 模型 设计 支持 通用 的 流程 对 象 (事件 、 
任务 、 角 色 等 ) ， 模 型 的 设计 可 以 在 Eclipse 平台 并 且 以 图 形 化 方式 进行 ， 直 观 的 设计 使 开发 
人 员 或 业务 人 员 更 方便 地 上 手 ， 流 程 任务 可 以 方便 地 集成 基于 角色 的 动态 视图 ， 也 可 以 实现 
复杂 的 审批 规则 需求 (SE, HET), 

从 开发 的 角度 来 看 ，SAP BPM 的 流程 设计 工具 已 集成 在 了 新 版 本 的 开发 工具 (NWDS) 
中 ， 可 以 通过 开发 工具 的 切换 透视 图 按钮 方便 地 切换 至 流程 设计 透视 图 ， 如 图 7-3 所 示 。 

简单 地 说 ， 整 个 流程 设计 的 过 程 包 含 了 以 下 几 个 步骤 : 

1) 创建 一 个 流程 并 进行 必要 的 “ 泳 道 ” 定 义 。 

2) 定义 流程 步骤 和 对 象 (任务 ) 。 

3) 开发 并 配置 流程 的 启动 方式 。 

4) 编译 并 部 署 流程 至 服务 需 端 。 

在 定义 流程 对 象 的 过 程 中 ， 既 可 以 通过 模型 设计 视图 中 鼠标 悬 停 在 流程 对 象 上 方 时 的 弹出 
菜单 进行 相关 对 象 的 定义 ， 也 可 以 通过 右 侧 的 流程 对 象 清单 进行 流程 设计 ， 如 图 7-4 所 示 。 


) planning 


+} Plug-in Development © | Palette 

DR Process Development ly Select 

3? Process Modeling Spt E} Marquee 
a 


® Provisioning eas 
lS Resource (default) = r A 
— Sequence Flow 


RB Rules Composer = 
§S SAP Management Console Activity 0 oO > Data Flow 
^ SAP Process Integration Administration = =) Association 


YS SAP Process Integration Designer parr — Message Flow 
给 SAp Process Integration Runtime = So Fow Objects 

六 Service Composer i 
&°Team Synchronizing 


» O Intermediate Event 
ElVisual Composer 一 


GY Web 国 © » O End Event 


» O Start Event 


End » © Activity 
[> V Gakawar 
(ok) [cancel (D Artifacts 
[H Swimlanes 
图 7-3 选择 透视 图 图 7-4 流程 建 模 界面 与 工具 栏 


在 BPM 流程 设计 过 程 中 ， 主 要 使 用 了 下 列 对 象 。 

e 动作 (Activity): 即 流程 中 的 一 个 步骤 由 于 表示 工作 或 者 动作 需要 被 执行 。 

© 网 关 (Gateway): 用 于 控制 流程 的 走向 ， 包 括 合并 和 分 散 的 动作 ， 同 时 只 能 通过 逻辑 

控制 走向 ， 它 本 身 不 能 进行 走向 的 判断 。 

© 事件 (Event): 一 个 标识 说 明 “ 事 件 发 生 ”， 可 以 用 于 局 动 、 和 暂停、 恢复 、 中 断 以 及 

重 定向 一 个 流程 或 者 动作 。 

SAP 为 了 满足 不 同 的 业务 需求 ， 对 于 流程 设计 的 这 3 种 对 象 也 提供 了 各 种 不 同 的 类 型 ， 
可 供 开 发 人 员 或 业务 人 员 进 行 选 择 。 

动作 的 类 型 及 其 说 明 见 表 7-1。 

表 7-1 动作 的 类 型 及 其 说 明 
动作 的 类 型 例 类 型 说 明 


Human Activity 用 户 动 作 ， 由 最 终 用 户 进行 任务 处 理 
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动作 的 类 型 


Ri 
2 


( 续 ) 


类 型 说 明 


Automated Activity 


Automated 0 


自动 动作 ， 由 系统 自动 完成 任务 处 理 


Mapping 0 


一 个 将 流程 中 上 下 文 进行 映射 的 简单 动作 ， 并 允许 


Mappi TA 
apping 其 他 接口 或 规则 进行 访问 
Embedded Sub Process 0 is F X a 4 
Embedded PAR Fit, ~A HAT AT nt BN 


Sub - Process 


网 关 的 类 型 见 表 7-2。 


网 关 的 类 型 


oe 


作 ， 触 发 将 进入 另 


Start Event0 End Event0 


表 7-2 网 关 的 类 型 及 其 说 明 


w 
= 


个 具体 流程 中 


类 型 说 明 


Exclusive Choice 


网 关 通 过 一 个 布尔 型 的 参数 表达 式 进行 馆 辑 判断 ， 
仅 有 一 个 出 口 可 以 被 选择 


eee 拆 分 网 关 ， 将 BPM 流程 拆 分 成 若干 并 行 的 流程 继 
arallel Split 续 流 转 

er 合并 网 关 ， 将 若干 并 行 的 流程 进行 合并 ， 与 上 面 拆 
oe 分 的 网 关 相 对 应 


Event based Choice 


仅 有 一 个 出 


口 可 以 被 选择 ， 但 逻辑 判断 是 通过 事 
来 决定 ， 而 不 是 参数 表达 式 


BD ED D 


Uncontrolled Merge 将 被 排除 的 BPM 流程 进行 合并 ， 且 选择 一 个 出 口 
a 继续 流转 
事件 的 类 型 及 其 说 明 见 表 7-3。 
表 7-3 事件 的 类 型 及 其 说 明 
事件 类 型 例 类 型 说 明 
oe 开始 事件 ， 作 为 流程 的 开始 事件 (包括 一 个 新 的 流 
程 或 者 子 流程 ) 
Re 时 钟 事件 ， 和 暂停 一 个 流程 一 段 时 间 ， 或 暂停 至 一 个 
IntermediateTimer Event 特定 时 间 
Intermediate ee PS THE Ale pe A TSEN sw 
消息 事件 ， 需 要 等 待 并 收 到 一 个 消息 


Message Event 


Intermediate Error 


以 报错 的 方式 终止 一 个 动作 


End Event 结束 事件 ， 结 束 一 个 流程 的 事件 
Termination 终止 事件 ， 立 即 终止 整个 流程 
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0000 


除了 上 述 的 一 些 关 键 对 象 之 外 ， 为 了 流程 能 够 让 人 一 目 了 然 ， 模 型 设计 中 还 提供 了 


“ 瀛 道 ” 的 创建 ， 通 过 “ 泳 道 ” 可 以 直观 地 区 分 出 流程 中 不 同 任务 的 执行 主体 ， 即 对 应 的 任 
务 处 理 部 门 或 岗位 。 


7.2.2 任务 定义 

从 某 种 意义 来 说 ， 模 型 的 设计 只 是 为 流程 定义 了 一 个 流转 的 框架 ， 经 过 对 实际 业务 流程 
的 分 析 ， 大 部 分 的 任务 步骤 都 是 通过 “用 户 动作 ” (Human Activity) 操作 完成 的 ， 如 审核 
和 确认 等 动作 。 从 逻辑 角度 来 看 ， 用 户 动作 的 内 容 是 通过 任务 的 定义 和 配置 来 实现 的 ; 而 从 
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用 户 的 使 用 角度 来 看 ， 每 一 个 任务 对 应 的 就 是 每 一 个 用 户 在 登录 客户 端 系统 后 看 到 的 “ 待 


办 任务 ”。 
使 用 开发 工具 可 以 很 方便 地 在 一 个 BPM 工程 中 ， 通 过 右 击 的 新 建 菜单 创建 一 个 流程 以 


及 对 应 结 点 的 任务 ， 如 图 7-5 所 示 。 


1. 属性 配置 
当 打开 一 个 任务 时 ， 会 看 到 任务 包含 了 概览 、 特 性 和 动作 、 角 色 、 用 户 文本 以 及 时 间 常 


量 等 几 个 选项 卡 ， 如 图 7-6 所 示 。 


4 55 Process Modeling 
4 (5 Processes 


es MyProcess 
4 @ Tasks 
É MyTask| Overview | Attributes and Actions | Roles | User Texts | Time Constraints 


图 7-5 流程 模型 目录 结构 到 7-6 不同 的 选项 卡 
e 在 概览 中 ， 可 以 定义 任务 的 基本 信息 ， 可 以 选择 是 否 需 要 邮件 通知 对 应 任务 的 待 办 接 
收入 ， 可 以 选择 当前 任务 的 优先 级 (将 显示 在 用 户 的 待 办 清单 中 )， 可 以 绑 定 任务 对 
应 Web Dynpro 程序 的 接口 视图 ， 但 视图 中 必须 有 事件 触发 动作 ， 用 于 触发 工作 流 继 
续 流转 。 由 于 Web Dynpro 程序 决定 了 用 户 在 打开 待 办 时 可 以 看 到 以 及 处 理 业 务 时 的 
页 面 ， 因 此 必须 绑 定 ， 如 图 7-7 所 示 。 
e 在 特性 和 动作 中 ， 可 以 配置 自 定义 的 特性 ， 并 且 可 以 使 用 一 些 模板 提供 的 逻辑 表达 
R, 还 可 以 配置 自 定义 的 动作 ， 如 图 7-8 所 示 。 


~v Custom Attributes 


Define the custom attributes for this task 


Sharing: W] Allow actual owner to invite contributors to this task 
Attributes: N Label T 
Notification: Send custom e-mail notification to potential owners ame ave ype 
Attributed Attributed string 
Locale: English 


v User Interface 


Define the UI component you want to use to execute instances of this task 


Component: 
一 一 v Custom Actions 
we ee , Define the custom actions for this task 
Set the default priority for this task . 
Actions: Name Label 
Priority: Medium 
图 7-7 概览 选项 卡 图 7-8 特性 和 动作 选项 卡 
。 在 角色 中 ， 可 以 定义 当前 任务 的 处 理 人 、 定 义 例外 用 户 以 及 定义 任务 的 管理 员 ， 如 
图 7-9 所 示 。 
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e 在 用 户 文本 中 ， 可 以 定义 一 些 特定 文本 的 变量 ， 用 于 任务 的 名 称 或 者 说 明 信 息 中 ， 当 
然 这 些 文本 也 可 以 使 用 流程 中 传递 的 上 下 文 特性 作为 参数 ， 动 态 地 生成 特殊 文本 ， 如 
图 7-10 所 示 。 


~ Variables 


Define the variables you want to use to parameterize the user texts below 


~ Potential Owners Variable; Name Type 


[Parate ression defined | 


Define the default list of potential owners for this task 


© Choo: or more UME principals 
Principal (Empty) 
© Use an expression ~ Parameterized Texts 


Define the text that will be sent as an e-mail notification and displayed in the user's inbox. Use 4 


Subject: MyTask 


Description: 


图 7-9 有 者 选项 卡 图 7-10 用 户 文本 选项 卡 


o 在 时 间 常 量 中 ， 可 以 指定 任务 的 延迟 触发 时 间 以 及 任务 的 过 期 时 间 ， 避 免 用 户 收 件 箱 

中 出 现 竺 办 任务 过 量 堆 积 ， 如 图 7-11 所 示 。 

2. 所 有 者 配置 

在 任务 的 属性 配置 中 ，Web Dynpro 接口 视图 的 定义 非常 重要 ， 因 为 视图 的 绑 定 决定 了 
用 户 处 理 业 务 的 页 面 选 择 以 及 实际 体验 ; 而 在 确定 接口 视图 之 后 ， 最 为 重要 的 则 是 任务 的 所 
有 者 配置 ， 因 为 所 有 者 的 配置 决定 了 哪些 人 有 可 能 会 收 到 任务 、 哪 些 人 不 会 收 到 任务 以 及 哪 
些 人 有 权限 可 以 对 任务 进行 终止 或 转发 ， 即 分 为 了 “潜在 所 有 者 ” “排除 所 有 者 ”以 及 “ 任 
务 管理 者 ”3 种 类 型 ， 如 图 7-12 所 示 。 


v Activation Time 


W] Activate this task by default when creating it 


2 5 ot ~ Potential Owners 
@ Use an offset relative to the task creation time 


Define the default list of potential owners for this task 


Offset: + fo Minutes bal 
@ Choose one or more UME principals 
Use an ex pression Sah F 
Principals: |(Empty) 
Expres | © Use an expression 
Expression: 
> Start Deadline = | 


» Completion Deadline » Excluded Owners 


» Expiration Time 


图 7-11 时 间 和 常量 选项 卡 图 7-12 所 有 者 配置 


在 3 种 类 型 的 所 有 者 配置 选项 卡 ， 都 包含 了 以 下 两 种 方式 进行 所 有 者 的 指派 : “Choose 
one or more UME principles”， 可 以 理解 为 UME 实体 ;“Use an expression” 使 用 表达 式 。 在 选 
中 “Choose one or more UME principals” 单 选 按钮 后 ， 发 现 其 实 不 仅 可 以 绑 定 用 户 ， 还 可 以 
绑 定 指定 的 组 、 角 色 或 用 户 ， 如 图 7-13 所 示 。 

除了 绑 定 静态 的 UME 实体 以 外 ，SAP 也 允许 通过 表达 式 动态 获取 审批 人 。 而 在 各 类 的 
实施 项 目 中 ， 发 现 绑 定 静 态 对 象 的 情况 很 少 存 在 ， 这 可 能 是 因为 配置 的 不 灵活 而 带 来 较 大 的 
工作 量 ， 容 错 率 非常 低 。 相 对 而 言 ， 表 达 式 的 情况 有 多 种 ， 一 种 是 将 整个 审批 规则 封装 成 一 
个 过 程 ， 在 表达 式 中 直接 调用 这 个 过 程 ， 常 见 的 如 使 用 EJB 实体 ; 另外 一 种 是 表达 式 直 接 
读 取 流程 上 下 文中 的 某 一 个 变量 ， 这 个 变量 已 经 存在 了 审批 规则 过 程 调用 后 的 结 
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| Principals 


Select Principals from UME 
Principal Name: 


Configure Default Server... 
User Search 


Search Results: Principals to Select: 


O) ok || cancel 


图 7-13 配置 UME ZAR 


直接 调用 过 程 的 形式 将 整个 审批 规则 工作 配置 化 ， 实 施 者 只 需要 配置 任务 属性 而 省 去 了 
代码 级 别 的 开发 。 绑 定 变量 的 方法 简单 、 直 接 ， 但 调用 规则 的 过 程 却 需要 Web Dynpro 程序 
来 实现 ， 从 一 定 程 度 上 增加 了 项 目 开 发 的 工作 量 。 由 于 通过 Task 直接 调用 过 程 ， 往 往 会 遇 
到 不 能 回 深 的 乾 粹 ， 当 新 的 任务 生成 时 会 执行 通过 规则 获取 审批 人 的 逻辑 ， 一 旦 执行 当中 出 
现 异常 ， 新 的 任务 就 可 能 会 生成 失败 。 最 终 的 结果 是 即使 能 够 通过 后 台 监 控 错 误 原 因 ， 但 流 
程 实例 本 身 也 会 因为 异常 不 能 回 深 ， 这 种 异常 情况 往往 对 流程 任务 处 理 者 来 讲 是 致命 的 ， 他 
们 通过 表象 不 能 判断 流程 的 实际 走向 ， 最 终 的 处 理 方式 也 只 能 是 重新 提 报 等 。 相 反 ， 直 接 绑 定 
变量 的 方式 却 因为 代码 级 别 的 原因 使 开发 人 员 能 够 合理 地 处 理 异常 ， 回 滚 已 经 执行 的 操作 。 

当然 不 管 是 通过 表达 式 调用 服务 ， 还 是 绑 定 某 一 个 动态 的 执行 者 变量 ， 区 别 仅 在 于 执行 
审批 规则 逻辑 的 时 间 顺 序 ， 执 行 审批 规则 的 过 程 是 必须 要 有 的 。 审 批 规则 对 应 于 流程 任务 处 
理 者 的 取 人 逻辑 ， 每 一 个 任务 生成 之 前 都 要 通过 适应 于 客户 需求 本 身 的 审批 规则 ， 而 现在 人 
们 已 经 把 这 个 过 程 模 块 化 ， 模 块 置 于 任务 生成 之 前 ,模块 的 输出 是 该 任务 精确 的 执行 者 。 值 
得 一 提 的 是 ， 每 一 个 规则 背后 都 包含 了 对 该 客户 或 公司 组 织 架构 的 次 层次 理解 与 分 析 ， 对 于 
不 同 的 公司 、 不 同 的 业务 模块 来 讲 ， 它 们 的 审批 规则 都 是 不 同 的 ， 或 者 说 人 们 还 无 法 抽象 出 
一 种 规则 ， 使 它 应 用 于 所 有 的 业务 场景 ， 但 规则 的 设计 却 有 一 个 最 终 的 目的 一 一 配置 化 的 灵 
活 、 简 单 与 扩展 。 当 企业 的 组 织 架构 出 现 调 整 ， 当 员工 的 岗位 级 别 发 生变 动 时 ， 规 则 能 够 通 
过 简单 的 配置 来 灵活 地 应 对 这 种 变化 ， 使 BPM 流程 本 身 也 具备 更 强 的 业务 兼容 性 。 

下 面 归纳 了 几 种 常用 的 设计 原型 : 

1) 自 定义 配置 审批 人 : 通过 自 定义 配置 表 来 配置 每 一 个 流程 结 点 的 审批 人 ， 配 置 表 直 
接 指 定 具体 岗位 或 人 员 。 配 置 表 的 属性 一 般 包含 流程 标识 (ID), 任务 标 识 ， 所 有 与 审批 相 
关 的 业务 类 型 、 业 务 数据 字段 ， 员 工 标识 。 对 于 一 个 具体 的 流程 实例 ， 通 过 已 知 的 流程 标 
识 、 任 务 标识 、 业 务 类 型 涉及 的 业务 数据 来 获取 相关 的 审批 人 。 这 种 方法 适用 于 大 部 分 通过 
业务 类 型 数据 不 同 指定 不 同 审批 人 的 情况 ， 并 且 配 置 表 已 经 具体 到 员工 标识 ， 通 过 配置 表 可 
以 实现 较 多 特殊 情况 的 审批 规则 ， 配 置 较为 灵活 ， 但 由 于 配置 的 过 程 对 所 有 细 分 的 情况 都 有 
涵盖 ， 初 始 化 的 配置 会 带 来 很 大 的 工作 量 ， 而 且 对 于 审批 规则 调整 的 适应 性 不 高 ， 企 业 人 员 
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体系 的 变化 或 者 岗位 调动 都 会 给 维护 带 来 较 大 的 工作 量 。 

2) 通过 角色 获取 审批 人 : 通过 角色 的 方式 配置 审批 规则 ， 相 当 于 对 审批 级 别 做 了 分 
类 ， 在 整体 审批 级 别 层次 较为 清晰 、 审 批 层次 对 应 的 人 员 集 合 较 为 固定 的 情况 下 比较 适用 。 
例如 ， 一 个 集团 所 有 流程 的 审批 最 多 就 是 三 级 ， 三 个 级 别 对 应 了 固定 的 专 册 人员， 那 就 可 以 
建立 三 个 角色 ， 每 一 个 角色 导入 这 些 专 岗 人 员 。 实 际 的 审批 过 程 是 从 角色 当中 取 人 ， 然 后 针 
对 这 些 人 员 组 合 做 进一步 过 滤 。 这 种 方法 的 优点 是 整个 配置 过 程 简单 ， 初 始 化 与 维护 都 不 会 
有 很 大 工作 量 ， 但 这 种 方式 只 是 针对 较为 简单 的 审批 场景 ， 对 于 复杂 的 业务 类 型 审批 往往 不 
能 够 满足 要 求 。 

3) 与 HR 系统 (模块 ) 的 集成 : 审批 规则 的 设计 与 ERP 中 的 HR 系统 集成 是 比较 好 的 
一 种 方式 ,一 方面 ， 由 于 审批 人 的 数据 源 就 是 来 源 于 HR 本 身 ， 因 此 不 用 关心 因为 人 员 级 别 
的 变化 而 带 来 的 影响 ; 男 一 方面 ，HR 已 有 的 数据 配置 也 大 大 减少 了 初始 化 的 配置 工作 量 。 
例如 ， 企 业 本 身 实 施 的 SAP 人 力 资源 模块 (Human Resource，HR) ， 针 对 流程 标识 ， 任 务 标 
识 的 配置 可 能 就 是 “组 织 - 职位 - 员工” (Organisations - Positions - Employees, O -S — P) 
的 一 种 ， 在 不 指定 具体 员工 的 情况 下 ， 组 织 和 职位 下 的 人 员 都 来 自 SAP HR 数据 ， 组 织 或 岗 
位 下 的 人 员 调 整 都 不 会 对 流程 的 实时 审批 产生 影响 。 当 然 采 用 这 种 设计 的 前 提 是 要 对 企业 的 
HR 系统 有 很 好 的 调研 与 理解 ， 而 且 审批 规则 确实 与 HR 的 体系 关联 很 大 ， 同 时 HR 提供 系 
统 接口 也 是 必然 ， 这 样 会 带 来 一 定 的 接口 集成 的 工作 。 


7.2.3 ”启动 方式 选择 


不 同 的 BPM 流程 可 以 有 多 种 启动 方式 ， 如 管理 者 平台 的 手动 触发 、Web 服务 启动 ，API 
调用 的 方式 启动 等 方式 。 通 过 流程 控制 台 手 工 启 动 流程 适用 于 对 基础 流程 的 场景 测试 ， 而 后 
两 种 则 是 从 开发 的 角度 发 起 流程 实例 ， 如 图 7-14 所 示 。 


Start 


Select a trigger for this event 


Event Trigger Trigger Type: © Message © Timer 
Output Mapping Trigger: DefaultService_Empty 
Start Condition New... 

D 


faultService_Empty 
DefaultService_EmptyAsync 


Al7-14 BPM 启动 事件 触发 需 的 配置 


比较 开发 端 两 种 启动 流程 的 方式 ，Web 服务 的 方式 从 接口 的 角度 来 讲 更 通用 也 更 规范 。 
对 于 其 他 系统 来 计 ， 通 过 调用 流程 的 Web 服务 就 可 以 发 起 BPM 流程 ， 但 客户 端 调用 的 过 程 
却 较 为 烦琐 。 对 于 每 一 个 Web 服务 都 要 有 一 个 生成 客户 端 代理 并 调用 服务 的 过 程 ， 而 且 如 
果 是 Web Dynpro 调用 Web 服务 ， 当 流程 的 启动 接口 结构 发 变化 时 ， 往 往 要 重新 导入 模型 ， 
使 因为 接口 结构 的 变化 带 来 了 客户 端 程序 的 调整 ， 同 时 由 于 BPM 发 布 后 生成 的 Web 服务 本 
身 是 异步 的 机 制 ， 不 能 通过 服务 返回 的 参数 来 判断 或 获取 流程 相关 的 信息 (如 标准 流程 
ID) ， 这 些 数 据 对 于 标准 的 流程 处 理 〈 如 取消 流程 等 操作 ) 都 是 必须 的 ， 因 此 通过 WS 启动 
流程 的 种 种 矣 端 让 大 部 分 实施 者 在 后 期 实施 中 采用 API 的 方式 来 启动 流程 。 比 较 前 者 相对 于 
规范 化 的 启动 接口 来 讲 ，API 的 启动 方法 可 以 适用 于 所 有 流程 ， 接 口 结构 的 变动 不 会 对 方法 
带 来 太 大 的 影响 。 男 外 ，API 具有 返回 参数 ， 参 数 中 包含 了 URI 形式 的 标准 流程 也， 这 些 都 
会 让 最 终 的 调用 过 程 变 得 高 效 ， 而 且 功 能 更 加 全 面 。 总 的 来 讲 ， 对 于 系统 间 的 服务 调用 来 发 起 
流程 ， 采 用 WS 是 比较 好 的 一 种 方式 ， 对 于 系统 本 身 的 流程 启动 更 多 的 是 倾向 于 标准 APL 
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1. 手动 触发 

使 用 管理 员 账 号 登录 NWA 平台 ， 在 菜单 中 选择 “Configuration”， 随 后 单 击 “Processes 
and Tasks” 就 能 打开 流程 和 任务 的 管理 界面 ， 如 图 7-15 所 示 。 

在 清单 中 列 出 了 所 有 成 功 部 署 至 服务 器 的 流程 ， 单 击 选中 任 一 流程 ， 在 下 方 任 务 清单 中 
选中 开始 事件 ， 随 后 单 击 “Start Process” 按 钮 ， 就 能 从 服务 器 端 手动 发 起 指定 流程 。 但 由 
于 这 种 方式 不 够 灵活 ， 且 必须 由 管理 员 手 动 进行 操作 ， 因 此 在 实际 项 目 应 用 中 较 少 使 用 。 

2. Web 服务 启动 

一 般 在 定制 流程 模型 、 开 始 事件 时 ， 都 会 关联 对 应 的 服务 接口 (Service Interface) ， 即 
流程 的 启动 服务 接口 (也 是 流程 发 布 服务 器 后 Web 服务 的 访问 接口 ) ， 对 应 于 Web 服务 的 
WSDL 地 址 ， 如 图 7-16 所 示 。 


Details of Component mybpm01 (demo.sap.com) and Version 20131219005942 (localDevelopment) 


pS es 4 DD Process Modeling 
( Processes andTasks | Resources g 


E Processes 
| Process Flow || Start Process @ Tasks 
后 | Name Q Event Triggers 
只 Gly Reporting Data Sources 
=" 
ComTask @ Rule Sets 
@ Functions 


DeptTask 
noe 国 Data Types 


4 (© Service Interfaces 
‘acationRegPro £8 http://www.example.org/NewWSD 
@ WSDL Files 


图 7-15 流程 中 的 任务 清单 图 7-16 项 目 目录 结构 


从 服务 定义 的 角度 来 说 ，BPM 在 部 署 到 服务 器 后 都 会 产生 一 个 对 应 的 Web 服务 ， 其 中 
包含 发 起 流程 的 方法 以 及 必要 参数 ， 通 过 调用 该 Web 服务 触发 相应 的 事件 就 能 启动 流程 ， 
并 传人 必要 参数 的 值 。 

开发 实例 : 

1) 通过 服务 接口 的 关键 参数 在 管理 员 平 台 的 “WS Navigator” 进 行 测试 ， 以 保证 在 使 
用 时 可 以 正常 运行 。 进 入 NWA 页 面 的 “SingleService” 服务 ， 并 输入 关键 字 进 行 搜索 ， 如 
图 7-17 所 示 。 


Service Definitions Consumer Proxies 


Search | Browse 
Find: |*Startinter* | Search by: [WSDL Port Type Name v | State: |( All) v| [Go 


Found Service Definitions: 1 


| WSDL Port Type Name = | Namespace 
P 
| | Startinter http//www.example.org/Startinter! 


图 7-17 搜索 服务 界面 


2) 查找 到 对 应 服务 后 ; Pa ROT AY “W/S- | Details about service definition "Startinter" 
DLs” 页 签 ， 并 单 击 “Test” 按钮 如 图 7-18 General d| WSDLs || Configuration Logs and Traces Classifications 
所 示 。 eae Test 

3) 随后 跳 转 至 Web 服务 测试 页 面 “WS = 
Navigator”， 单 击 “ 下 一 步 ”按钮 ， 如 图 7-19 17-18 WSDL 界面 


所 示 。 
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4) 输入 必要 的 执行 方法 参数 ， 单 击 “ 下 一 步 ”按钮 ， 如 图 7-20 所 示 。 


“服务 测试 | 测试 场 六 


-B-B oo: i 
BS wate Hast HR 
— 1 2 > * ia 
4 上 一 步 F¥— »] || 调用 参数 作用 a= CEE Bi BF BASH ER 
服务 信息 = 
上 一 步 | T- »] || [Saex | | | 
操作 服务 信息 
ie BASE 参数 
Z =X [all $2] | [5E 
| | NewOperation + L) NewOperation: 2, 
图 7-19 选择 对 应 操作 图 7-20 输入 参数 值 


5) 执行 完成 后 ， 通 过 执行 返回 消息 确认 服务 执行 成 功 ， 如 图 7-21 所 示 。 

6) 接 下 来 通过 在 Web Dynpro 工程 中 模型 导入 Web 服务 ， 并 创建 对 应 的 执行 方法 或 生 
成 自 定 义 控制 器 进行 执行 ， 便 能 达到 代码 端 启动 流程 的 目的 ， 如 图 7-22 所 示 。 
Models 


4 3 StartinterModel 
4 @ Model Classes 


B Eg 0 秒 内 成 功 执行 操作 "NewOperation” 动 , Request NewOperation 
Ê Response_NewOperation 
服务 测试 测试 场景 @ Context 


图 7-21 测试 结 图 7-22 导入 模型 


3. 流程 API 启动 

通过 API 启动 流程 是 在 NetWeaver 7. 2 及 更 新 版 本 中 提供 的 更 受 开 发 人 员 欢 迎 的 一 种 方 
式 ， 因 为 它 相对 于 Web 服务 的 定义 和 使 用 来 说 ， 更 加 地 简洁 和 直接 。 值 得 一 提 的 是 ， 在 新 
版 本 中 SAP 不 仅 公 开 了 BPM 启动 流程 的 API， 还 提供 了 对 操作 任务 的 API 以 及 操作 流程 的 
ey 这 些 API 使 开发 者 实现 各 种 各 样 的 增强 (包括 对 流程 的 动态 控制 ) 成 为 

可 能 ， 有 时 通过 API 的 使 用 也 能 达到 一 些 意 想不到 的 效果 。 

使 用 API 启动 流程 的 代码 示例 : 


//@ @ begin startProcess( ) 
try | 
logger. infoT(" 标准 API Ja ay FE :" ) ; 
// 获取 流程 定义 管理 器 


ProcessDefinitionManager processDefinitionManager = BPMFactory 


. getProcessDefinitionManager( ) ; 

// 获取 流程 的 定义 ,赋值 流程 技术 名 称 vendor dename processname 

ProcessDefinition activeProcessDefinition = 
processDefinitionManager 

. getActiveProcessDefinition( " demo. sap. com" , "mybpm01" , 
"VacationRegPro" ) ; 

if( activeProcessDefinition == null) | 

logger. errorT(" 标准 API 启动 流程 ,启动 失败 " ) ; 

return ; 

| 

// 获取 流程 启动 管理 器 

ProcessStartManager processStartManager = BPMFactory 

. getProcessStartManager( ) ; 
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// 获取 流程 启动 事件 
Set < ProcessStartEvent > processStartEvents = processStartManager 
. getProcessStartEvents( activeProcessDefinition. getId( ) ) ; 
ProcessStartEvent processStartEvent = 
processStartEvents. iterator( ). next( ) ; 
// 创建 流程 启动 入 口 参数 
DataObject doStart = processStartManager 
. createDataObjectForStartEvent( processStartEvent ) ; 
// 根据 StartInterface 人 口 参数 逐 级 创建 DataObject 
DataObject baseInputDO = doStart. createDataObject( " BusiData" ) ; 
// 发 起 人 
baseInputDO. setString( " startUser" , " test00" ) ; 
// 发 起 人 部 门 
baseInputDO. setString( " startUserDept" , "1001" ) ; 
// 下 级 审批 人 unique id 
baseInputDO. setString( " nextApprPers" , 
"USER. PRIVATE_DATASOURCE. un:test01" ) ; 
// process pool name 
baselnputDO. setString("poolName" , "请 假 申 请 " ) ; 
// 下 一 级 结 点 , 结 点 号 根据 流程 配置 动态 获取 
baseInputDO. setString( " taskNode" , "20" ) ; 
// 公司 代码 (发 起 人 ) 
baseInputDO. setString( " bukrs" , "0001" ) ; 
// WX 
baseInputDO. setString( " gateWay", "") ; 
// 产生 的 自 定义 表 流 程 站 ， 可 以 定义 各 种 生成 规则 ， 保证 并 发 唯一 ,此 处 为 模拟 生成 
String processld =" P20130000000000001 人 
// 任务 名 称 ,标题 根据 流程 配置 动态 获取 
baseInputDO. setString( "taskName" , processld + "请假 申 请 一 级 审核 " ) ; 
// roadMap 的 字符 串 存储 
baseInputDO. setString( "roadMapStr" , "" ) ; 
// 操作 事务 码 
baseInputDO. setString("transacCode" , "" ) ; 
// autoID( 存 表 时 自动 生成 主键 ) 
baseInputDO. setString( " metAutold" , autold) ; 
// 流程 流水 号 
baseInputDO. setString(" procNumber" , proNumber) ; 
// 流程 所 属 流程 定义 码 
baseInputDO. setString( " processCode" , " P0001" ) ; 
baseInputDO. setString("taskNumber" , ""); 
doStart. set( " BusiData" , baseInputDO) ; 
// 启动 流程 


URI startProcess = processStartManager. startProcess( 


guy 


processStartEvent, doStart) ; 
logger. infoT(" 启动 流程 成 功 1" ) ; 
// 流程 启动 成 功 返 回 URI 和 流程 的 ProcessInstanceld 
String uri = startProcess. toString( ) ; 
// uri 转化 为 字符 串 格 式 
// bpm://bpm. sap. com/process — instance/ + saptaskid 
String[ ] split = uri. split(" process — instance/" ) ; 
// 标准 流程 ID 取 分 隔 符 最 后 部 分 
wdComponentAPI getMessageManager( ). reportSuccess( " Process Start 
Success!" ) ; 


return ; 
| catch( Exception e) | 
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logger. errorT(" 流程 启动 失败 " + e. getMessage() ) ; 


return ; 


} 
//@ @ end 


注 : 这 段 Web Dynpro 中 的 代码 只 有 添加 对 “tc/bpem/facade/ear” 与 “te/je/sdo21/api” 
两 个 标准 软件 组 件 的 依赖 才能 编译 通过 。 


7.3 BPM 流程 桌面 


SAP 的 BPM 流程 桌面 主要 包含 以 下 几 个 功能 : 

。 通用 工作 清单 ， 作 为 所 有 待 办 任务 、 提 醒 事 件 以 及 通知 消息 的 统一 收 件 箱 。 

© 待 办 处 理 框 架 ， 在 Web Dynpro 工程 页 面 之 外 提供 了 一 些 流程 处 理 的 标准 功能 (A 
要 进行 Web Dynpro 的 额外 开发 ) 。 

e 门户 中 的 流程 清单 视图 ， 用 于 显示 具体 流程 以 及 结 点 的 相关 信息 ,方便 用 户 对 流程 进 
行 一 定 程 度 的 监控 。 


7.3.1 通用 工作 清单 


1. 通用 工作 清单 配置 

通用 工作 清单 (Universal Worklist, UWL) 是 SAP NetWeaver 架构 之 上 系统 的 待 办 工作 
平台 。 通 过 配置 不 同系 统 的 连接 器 ，UWEL 可 以 集中 地 显示 多 个 平台 不 同 的 工作 流 待 办 ， 包 
括 流程 任务 、 警 告 、 提 醒 等 内 容 。 通 常情 况 下 ， 通 用 工作 清单 更 多 地 应 用 于 BPM 的 待 办 清 
单 ， 用 户 登 录 SAP 企业 门户 后 就 可 以 查看 属于 自己 的 待 办 事项 ， 并 通过 UWL 提供 的 功能 查 
看 待 办 明细 。 单 击 待 办 标题 ， 也 可 以 打开 对 应 的 业务 处 理 页 面 (包括 Web Dynpro 开发 页 面 、 
ERP 系统 的 GUI 页 面 或 是 其 他 第 三 方 系统 的 页 面 ) 人 处 理 相 关 业 务 ， 如 图 7-23 所 示 。 


通用 工作 清单 


任务 (2/4) s 通知 单 SAPoffice 邮件 | BE 


显示 : [新 的 和 运行 中 的 任务 (2/4) les 局 | 


Q 主题 ! #6 发 送 日 期 优先 级 
请 候 申请 一 经 颖 加 2013-12-26 + 
E it 2013-12-26 + 
2013-12-19 中 


到 7-23 ”通用 工作 清单 


从 配置 角度 来 看 ， 通 用 工作 清单 是 企业 门户 [El 

中 一 个 默认 提供 的 门户 视图 ， 参 考 中 文 日 录 在 门 mp 

户 内 容 中 的 “门户 内 容 / 由 SAP 提供 的 内 容 /最 终 | [ore 

用 户 目录 /标准 门户 用 户 /iView/eom. sap. netweav- | petot terava t dsnsyng sasits osts = 

er. be. uwl. iviews/ 通 用 工作 清单 ”。 门 户 配置 人 员 | punon = 

可 以 通过 查看 或 修改 该 视图 的 属性 对 通用 工作 清 | Seem = 

单 进行 一 些 简单 个 性 化 设置 ， 如 图 7-24 所 示 。 = 
在 系统 的 标准 角色 中 ， 用 户 核 心 角色 “pcd: -二 


» 图 7-24 通用 工作 清单 的 属性 
portal_content/every_user/general/eu_core_role” 已 
经 添加 了 通用 工作 清单 视图 的 增 量 链 接 ， 因 此 普通 用 户 添 加 了 该 角色 ， 就 可 以 在 门户 页 面 中 
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看 到 通用 工作 清单 。 对 于 一 些 个 性 化 的 用 户 需求 ， 也 可 以 新 建 自 定义 的 门户 和 角色， 并 添加 
UWL 视图 形成 自己 的 主页 目录 结构 ， 如 图 7-25 所 示 。 


角色 内 容 导航 结构 预览 四 
we. | 07] | (SSS) Se] 22 | EA | ss] | eee ee | 
2% 入 口 点 TR 排序 优先 级 合并 
7 RIStRr Rone | v 100.0 是 * me 
Ds 主页 M M 1.0 是 a 
~ [hex [v] iv] 1.0 & 
~ Daa El YM 100.0 是 
。 国 通用 工作 清单 口 M 100.0 = 


图 7-25 标准 角色 配置 


通用 工作 清单 作为 工作 项 目 收 件 箱 或 任务 列表 ， 是 用 户 访 问 工作 流 “TODO” 列 表 的 渠 
包含 了 下 列 优 点 : 

1)“ 统 一 ”的 收 件 箱 ， 接 收 所 有 的 任务 。 

2) 使 用 单一 固定 的 处 理 页 面 。 

3) 方便 使 用 ， 同 时 也 支持 客户 化 的 定制 。 

4) 支持 多 渠道 访问 。 

5) 与 SAP NetWeaver 平台 集成 ， 通 过 门户 集中 访问 。 

2. 通用 工作 清单 API 实例 

SAP 在 新 版 本 中 已 经 公开 了 部 分 UWL 的 API， 以 供 开发 者 通过 代码 的 方式 读 取 待 办 数 
据 ， 同 时 通过 BPEM 开发 包 中 的 “TaskInstanceManager” 类 ， 也 可 以 读 取 竺 办。 

从 实际 调用 的 情况 来 看 ，UWL 的 API 构造 的 各 种 参数 较为 复杂 ， 需 要 对 方法 的 输入 / 输 
出 结构 有 很 好 的 掌握 。 相 对 而 言 ， 使 用 BPEM 的 API 调用 的 过 程 比较 简单 ， 方 法 默认 做 了 权 
限 处 理 ， 只 能 查询 登录 用 户 的 竺 办， 对 于 大 数据 量 的 待 办 清单 查询 ，BPEM API 的 效率 要 优 
于 前 者 。 下 面 分 别 通过 两 个 实例 具体 介绍 两 种 方法 的 使 用 和 相关 代码 。 

开发 实例 : 

1) 编辑 任意 一 个 Web Dynpro TERSAK, OJE [ma] 

个 按钮 并 创建 按钮 的 默认 动作 ， 如 图 7-26 所 示 。 

2) 使 用 UWLAPI 的 参考 代码 ; 


is 


图 7-26 运行 效果 


try| 

Properties env = new Properties( ) ; 

env. put( InitialContext. INITIAL_CONTEXT_FACTORY , 
"com. sapportals. portal. prt. registry. PortalRegistryFactory" ) ; 
//3X HL uwlservice 

InitialContext ctx = new InitialContext( env) ; 

IUWLService uwlService = (IUWLService) ctx 

. lookup(""/broker/services/" + IUWLService. ALIAS_KEY) ; 
// 设 置 访问 超时 时 间 

final int sessionIdleTimeout = 600 ; 

UWLContext uwlContext =new UWLContext( ) ; 
/赋值 当前 登录 账户 

IWDClientUser clientUser = WDClientUser. getCurrentUser( ) ; 
[User user = clientUser. getSAPUser( ) ; 

uwlContext. setUser( user) ; 

uwlContext. setLocale( Locale. getDefault() ) ; 
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// 启 动 访 问 会 话 

IUWLSession uwlSession; 

uwlSession = uwlService 

. beginSession ( uwlContext, sessionIdleTimeout) ; 

uwlContext. setSession( uwlSession ) ; 

// 获 取 itemManager 

IUWLItemManager itemManager = uwlService. getltemManager( uwlContext ) ; 
// 获 取 uwlView 

UWLView uwlView = uwlService. getViewManager( uwlContext ) 
. getViewForltemType(ItemType. UWL_ITEM, uwlContext) ; 
QueryProperties queryProperties = new QueryProperties( ) ; 

// 设 置 返回 最 大 条 目 数 

queryProperties. setMaxNumberOfltemsToFetch( 300); 
/定义 排序 字段 

String[ | sortBy = | Item. CREATED_DATE } ; 
queryProperties. setSortBy( sortBy ) ; 

boolean[ | sortAscending = | true | ; 


queryProperties. setSortAscending( sortAscending ) ; 
// 调 用 API 获取 结果 集 
QueryResult qrs = itemManager. refreshCacheAndGetltems( uwlContext, 
uwlView, queryProperties, null); 


ItemCollection items = qrs. getltems( ) ; 
Item item = null; 
// 3th JNB El 
for(int i = items. size() -1;i >=0;i-— ) | 
item = items. get(i) ; 
String subject = item. getSubject( ) ;任务 标题 
this. wdComponentAPI. getMessageManager( ). reportSuccess( subject) ;// 打 印 标 题 
| 
} catch( NamingException e) | 
this. wdComponentAPI getMessageManager( ). reportException(e) ; 
| catch( Exception e) | 
this. wdComponentAPI getMessageManager( ). reportException(e) ; 


| 


3) 部 署 并 运行 应 用 后 测试 按钮 ， 打 印 的 内 容 与 待 办 清单 的 
= = YF 请 假 申 请 一 级 审 
示 条 目 一 致 ， 如 图 7-27 所 示 。 T 请 候 申 请 二 级 审批 


4) 第 二 个 按钮 使 用 BPEM API， 参 考 代码 如 下 : 


图 7-27 提示 消息 


TaskInstanceManager taskInstanceManager ; 
try | 
taskInstanceManager = BPMFactory. getTaskInstanceManager( ) ; 
HashSet < Status > statuses = new HashSet < Status > ( ) ; 
statuses. add( Status. READY) ; 
statuses. add( Status. RESERVED) ; 
statuses. add( Status. IN_PROGRESS) ; 
Set < TaskAbstract > myTasks = taskInstanceManager 
. getMyTask Abstracts (statuses ) ; 
for( Task Abstract task ; myTasks) | 
wdComponentAPI. getMessageManager( ). reportSuccess (task. getPresentationName( ) ; 
| 
} catch( Exception e) | 
wdComponentAPI. getMessageManager( ). reportException(e. getMessage( ) ) ; 
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logger. errorT( e. getMessage( ) ) ; 


| 


5) 部 署 并 运行 应 用 后 测试 按钮 ， 打 印 的 内 容 与 “UWL API” 按 钮 一 致 ， 条 目 没 有 排 
序 ， 如 图 7-28 所 示 。 

注 : 使 用 API 的 Web Dynpro 工程 ， 只 有 依赖 UWL 与 BPEM 的 标准 组 件 包 ， 才 能 引用 相 
关 的 API 并 调用 ， 包 括 “te/kmc/bc. uwl/api” “ tc/bpem/facade/ear” 以 及 “tc/je/userman- 
agement/api”， 如 图 7-29 所 示 。 


Da teyaiiybaseyofflineyfacade 
Da tefbl/exception/lib 
Da tc/bl/logging/api 

[Ba te/bpem/facade/ear 

Da tefemi i 

Da tc/ddic/runtime/ facade 


pa te jefusermanagement/ api 


areas 
请 假 申 请 二 级 审批 
(A 请 假 申 请 一 级 审批 
图 7-28 提示 消息 图 7-29 需要 依赖 的 开发 组 件 

3. 客户 化 工作 清单 

由 于 实际 的 项 目 中 客户 往往 提出 大 量 的 个 性 化 、 定 制 化 的 需求 ， 如 待 办 清单 中 需要 显示 
一 些 业务 数据 等 ， 这 样 SAP 标准 的 通用 待 办 清单 的 功能 就 大 大 受 限 ， 需 要 自 定义 的 待 办 清 
单 来 适应 这 种 增强 。 通 过 平台 提供 的 API， 可 以 从 代码 端 获 取 后 台 的 待 办 数据 ， 并 自 定义 待 
办 清单 来 满足 特殊 的 业务 场景 。 

开发 实例 : 

1) 自 定义 开发 的 工作 清单 功能 区 。 图 7-30 中 的 工作 清单 通过 API 读 取 并 打印 了 待 办 
标题 。BPM 中 的 待 办 标题 是 可 以 通过 变量 的 形式 动态 设置 的 ， 动 态 设置 的 标题 存储 于 标准 
表 中 ， 通 过 标题 中 的 关键 字 可 以 实现 标准 表 与 自 定 义 表 的 关联 ， 从 而 显示 与 待 办 相关 的 业务 
数据 ， 如 图 7-30 所 示 。 


竺 办 事项 已 办 事项 已 发 起 流程 | 暂 存 数据 


te/lme/be. uwl/ api 
Da tcywdfapi 


a ee 


FEAA Q mane | 由 全 反选 || Pisa | Reeve | 待 办 类 型 | [=| srra [= 
图 7-30” 自 定义 工作 清单 示例 


2) 自 定义 开发 的 工作 清单 内 容 区 。 数 据 库 设计 中 会 定义 一 张 与 标准 表 实 例 一 一 对 应 的 
流程 表 。 自 定义 的 流程 表 中 可 以 包括 除 流程 属性 外 的 所 有 业务 关键 数据 ， 当 流程 启动 时 ， 会 
在 自 定 义 表 中 搬入 一 条 流程 数据 ， 同 时 流程 主键 会 随 着 流程 上 下 文 在 流程 中 传递 ， 每 一 个 待 
办 任务 结束 并 产生 下 一 个 待 办 时 ， 流 程 主键 都 会 包含 在 新 的 待 办 标题 中 ， 最 终 通过 解析 标题 
数据 得 到 流程 关键 值 ， 并 关联 自 定 义 表 将 流程 属性 与 业务 数据 显示 在 通过 Web Dynpro 开发 
的 自 定义 工作 清单 中 。 页 面 元 素 通 过 选项 卡 集 以 及 表格 的 形式 对 待 办 清单 以 及 待 办 任务 重点 
信息 进行 展示 ， 如 图 7-31 所 示 。 


特 办 事项 已 办 事项 


ip re 公司 代码 部 门 HED 标准 任务 D 
[| @subject @bukrs @dept @processid @saptaskid 
| | @subject @bukrs @dept @processid @saptaskid 
门 | @subject @bukrs @dept @processi id @saptaskid 


K 7-31 自 定义 流程 表示 例 
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3) 其 中 标题 使 用 的 是 流程 流转 中 的 动态 变量 ， 即 在 任务 的 属性 定义 中 将 任务 名 称 修 改 
为 变量 “ | taskName|”， 而 在 上 方 变量 定义 处 ,将 该 变量 与 流程 “UIRequest” 中 上 下 文 的 
特性 进行 映射 ,任务 的 名 称 ( 待 办 的 标题 ) 就 可 以 通过 程序 的 上 下 文 进行 自 定义 设置 ， 如 
图 7-32 所 示 。 


加 AppTask £3 
User Texts 


v Variables 


Define the variables you want to use to parameterize the user texts below 


Variable: Name Type Expression 
taskWame string UIRequest/Context/ProcessNode/BusiData/taskName 


v Parameterized Texts 


Define the text that will be sent as an e-mail notification and displayed in the user’s inbox. Use braces ({}) to reference 4 


Subject: {taskWame} | 
Description: ii 


K 7-32 自 定 义 任务 配置 


4) 另外 ,流程 清单 中 的 公司 代码 、 部 门 代码 通过 与 自 定义 表 的 数据 关联 获取 ， 流 程 标 
识 是 自 定义 流程 实例 表 的 主键 值 ， 而 标准 任务 标识 是 BPM 标准 表 中 生成 的 任务 主键 值 ， 通 
过 BPEM 的 API 在 初始 化 时 编写 待 办 获取 人 逻辑 ， 参 考 代码 如 下 : 


IUwldataNode nodeUwldata = wdContext. nodeUwldata( ) ; 
IUwldataElement createAndAddUwldataKlement = null ; 
TaskInstanceManager taskInstanceManager ; 
try | 
taskInstanceManager = BPMFactory. getTaskInstanceManager( ) ; 
HashSet < Status > statuses = new HashSet < Status > ( ) ; 
statuses. add( Status. READY) ; 
statuses. add( Status. RESERVED) ; 
statuses. add( Status. IN-PROGRESS) ; 
Set < TaskAbstract > myTasks = taskInstanceManager 
. getMyTask Abstracts( statuses ) ; 
for( TaskAbstract task ; myTasks) ) | 
// 通 过 URI 获取 标准 任务 ID 
URI uri = task. getld( ) ; 


ON 
?9 


String sapTaskId = 
if(uri !=null) | 
String strUri = uri. toString() ; 

sapTaskId = strUri. substring( strUri. lastIndexOf("/") +1, 
strUri. length() ) ; 

| 

// 获 取 Task Subject 

String subject = task. getPresentationName( ) ; 

if( subject == null) 

subject = " (无 主题 )" ; 

// 解 析 标 题 获 取 流 程 中 传递 的 PROCESSID 

String processld = "" ; 


if( subject! = null&&subject. length( ) >18)| 
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| 


mney 
9 


String bukrs = 


" Mee 


String dept = 
He EBES 
* String sql = 


Li 


// IRIE PROCESSID 
// 赋 值 SAPTASKID 
// 赋 值 标题 


// 赋 值 公司 


// 赋 值 部 门 


| 


| catch( Exception e) | 


| 


// 自 定义 标题 字符 串 拼接 规范 [ PROCESSID(18) + 标题 内 容 ] 
processld = subject. substring(0, 18) ; 


// 通 过 PROCESSID 关联 自 定 义 流 程 表 ,获取 公司 .部 门 


* sql = "select ties depr from t_process where processid = 
+ processld + 
* 通过 Connection 执行 的 sql resultset 

* 注 :严格 意义 讲 , 此 处 是 调用 数据 库 的 操作 , 即 通 过 封装 的 Dao 逻辑 查询 流程 的 公司 、 


部 门 。 
+ 此 处 直接 模拟 了 这 一 过 程 
*/ 
bukrs = "0001" 
dept =" 1001" "s 


// 通 过 标准 API 获取 的 数据 构造 自 定义 清单 数据 
createAndAddUwldataElement = nodeUwldata. createAndAddUwldataElement( ) ; 


createAndAddUwldataElement. setProcessid( processId ) ; 
createAndAddUwldataElement. setSaptaskid( sapTaskId ) ; 
createAndAddUwldataElement. setSubject( subject) ; 
createAndAddUwldataElement. setBukrs(bukrs ) ; 
createAndAddUwldataElement. setDept( dept) ; 


wdComponentAPI. getMessageManager( ). reportE:xception(e. getMessage() ) ; 
logger. errorT(e. getMessage( ) ) ; 


i m0 
> 


代码 说 明 : 从 编写 的 逻辑 上 可 以 看 出 ， 每 遍历 一 次 通过 API 读 取 的 结果 集 都 要 通过 建立 
数据 库 连 接 ， 访 问 与 数据 库 获 取 流程 相关 的 业务 数据 ， 当 数据 量 较 大 时 ， 程 序 运 行 效率 会 降 
低 。 由 于 数据 源 的 特殊 性 使 得 开发 人 员 无 法 保证 能 够 直接 通过 数据 表 关 联 的 形式 读 取 数据 ， 
因此 考虑 建立 临时 表 或 主键 值 集 合 的 形式 去 优化 整个 查询 过 程 是 一 个 PANT: o 
时 表 的 方案 ,逻辑 处 理 更 为 简洁 ， 效 率 更 高 ， 但 需要 额外 的 表 空 间 ， 是 典型 的 通过 空间 换取 
时 间 的 做 法 。 相 关 开 发 步骤 如 下 : 


1) 调用 API 并 循环 结果 集 时 ， 只 是 往 临 时 表 里 批 量 插 和 数据， 数据 包括 标准 表 信 息 。 
2) 通过 临时 表 直 接 关联 查询 自 定义 流程 表 并 填充 自 定义 待 办 清单 对 应 的 结 点 数据 ， 采 
用 集合 的 形式 在 第 一 步 通过 字符 串 拼 接 流程 ID ， 同 时 填充 已 有 的 数据 至 结 点 ， 随 后 通过 
SQL IN 的 集合 查询 方法 一 次 性 查询 所 有 业务 数据 。 

3) 再 次 遍历 Node， 并 赋值 通过 第 二 步 批量 查询 的 流程 数据 。 

通过 上 面 的 步骤 可 以 看 到 ， 建 立 临时 表 的 方式 在 步骤 上 比 之 前 分 析 的 两 种 方式 都 简单 ， 


但 效率 却 是 最 低 ， 最 后 一 种 集合 查询 的 方法 对 于 数据 量 不 是 很 大 的 情况 下 可 以 使 用 。 另 外 ， 
从 上 面 的 例子 中 可 以 看 出 ， 通 过 BPM 的 APT 读 取 的 待 办 数据 并 没有 按照 某 一 条 件 进 行 排序 ， 
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对 于 排序 的 需求 可 以 根据 不 同 的 查询 方式 ， 通 过 SQL 语句 中 的 排序 逻辑 来 实现 。 
4) 由 于 流程 的 标题 通过 程序 的 上 下 文 进行 定义 ， 因 此 在 流程 启动 时 千 万 不 要 忘记 初 
始 化 流程 标题 ， 并 且 每 一 级 结束 的 按钮 方法 代码 中 根据 流程 启动 配置 更 新 任务 标题 ， 如 


图 7-33 所 示 。 


baseInputDO.setString ("taskName", 
/ roadmap 的 字符 趾 存储 + 


baseInputDO.setString("roadMapStr", "");+ 


/ 产生 的 
String processId = "P20130000000000001";+ 
/ 任务 名 称 ,标题 根据 流程 配置 动态 获取 + 


定义 表 流程 TID， 可 以 定义 各 种 生成 规则 ,保证 并 发 唯一 ， 此 处 为 模拟 生成 。 


=. 


ProcessId+" 请 假 申 请 一 级 审核 ”) ;+ 


WR] 


7-33 


自 定 义 代 码 


5) 实例 运行 后 的 待 办 清单 ， 如 图 7-34 所 示 。 


7.3.2 任务 执行 


( 竺 办 事项 | 已 办 事项 
T 标题 SIRA 
| | 请 假 申请 一 级 审核 0001 


| 部 
1001 
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流程 ID 
P20130000000000007 


当 用 户 单 击 任意 一 个 待 办 任务 时 ， 将 会 在 浏览 器 中 打开 一 个 新 窗口 并 进入 对 应 的 任务 处 
理 页 面 。 任务 处 理 页 面 除 了 在 任务 中 绑 定 的 Web Dynpro 接口 视图 或 者 其 他 系统 的 集成 页 面 
外 ， 还 有 一 个 SAP BPM 提供 的 标准 BPM 任务 处 理 框 架 ， 如 图 7-35 所 示 。 


| ee 
1 HERA NAHR YE Progress AR 
ti [| Woda 


n: PRES, HA TERRE 


ELi 
J| passaa 


注释 区 
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7-35 ”标准 任务 处 理 机 


可 以 看 到 ， 整 个 页 面 的 最 上 方 是 任务 标题 栏 ， 用 于 显示 任务 的 标题 、 开 始 时 间 、 状 态 、 
优先 级 等 信息 ; 在 任务 栏 下 方 是 工具 栏 ， 包 含 了 按钮 以 及 标准 功能 链接 ， 链 接 分 别 用 于 打开 
附件 区 以 及 注释 区 (默认 是 关闭 状态 ， 在 单 击 链接 后 才 会 显示 ) ; 整个 截图 只 有 左下 方才 是 
实际 的 应 用 区 (图 中 是 Web Dynpro 的 接口 视图 对 应 内 容 的 显示 ) 。 

其 中 工具 栏 包含 了 3 个 标准 功能 按钮 。 

1) “关闭 ”按钮 : 仅 关闭 当前 处 理 页 面 ， 不 是 关闭 流程 ， 待 办 仍然 留 在 待 办 清单 中 ; 
但 是 在 关闭 后 任务 的 状态 会 发 生变 化 ， 从 “新 (New)” 变 成 了 “进行 中 (In Progress)”。 

2) “委派 ”按钮 : 将 任务 委派 给 一 个 指定 用 户 ， 但 是 指定 的 对 象 必须 是 任务 的 执行 人 ; 
如 果 想 要 长 期 委派 ， 如 审批 人 需要 出 差 一 段 时 间 无 法 登录 系统 ， 则 需要 在 通用 工作 清单 中 进 
行 长 期 自动 委派 的 设置 。 

3)“ 撤 销 ” 按 钮 ,需要 注意 的 是 ， 同 一 个 任务 仅 能 由 一 个 用 户 进 行 处 理 ( 并行 分 支 中 
的 不 同 任务 可 以 由 多 用 户 处 理 ) ， 一 旦 一 个 用 户 打 开 ， 其 他 可 处 理 用 户 中 的 待 办 也 会 消失 ， 
因为 系统 认为 任务 已 经 被 “认领 ”了 。 所 以 如 果 用 户 在 打开 任务 后 发 现 自 己 无 法 处 理 ， 则 
需要 单 击 “ 撤 销 ” 按 钮 ， 这 样 其 他 处 理 用 户 才能 在 工作 清单 中 重新 看 到 该 任务 。 


7.3.3 流程 监控 


使 用 管理 员 账 号 登录 NWA 平台 ， 在 菜单 中 选择 “Configuration”， 随 后 单 击 “Processes 
and Tasks” 就 能 打开 流程 和 任务 的 管理 界面 ， 如 图 7-36 所 示 。 


Details of Component mybpm01 (demo.sap.com) and Version 20131219005942 (localDevelopment) 
Processes and Tasks | Resources 


T. Name 

S 
r ComTask 
mi DeptTask 
| | ReqTask 


VacationRegPro 


图 7-36 ”流程 管理 中 的 任务 清单 


选中 需要 查看 的 流程 ， 单 击 “Show Process Flow” 按 钮 ， 如 图 7-37 所 示 。 


Manage Processes: Process Instances 


Favorites, Related Links, GoTo, Support Details 


A 
Show Process Flow || Show Related Tasks 


Show: |All Running Processes ~| | | Actions 4] | | Ar Recover || Export Process Detail 
Find Process Instance: [ | Go 
Error Status | Status Process Name Process Subject Process Instance ID 
下 
[|= oK In Progress VacationRegPro Pool 0 €ca993cd684811e3ac0400000048cc86 


图 7-37 流程 实例 操作 页 面 


在 弹出 的 页 面 中 就 可 以 查看 运行 时 的 流程 流转 图 ， 根 据 上 面 流程 的 运转 情况 可 以 知道 该 
流程 处 于 二 级 审批 ， 如 图 7-38 所 示 。 


32] 


VacationRegPool 


图 7-38 标准 的 流程 流转 图 


7.4 BPM 开发 实例 


在 简单 地 了 解 了 BPM 的 组 成 部 分 后 ， 下 面 通过 一 个 实际 的 例子 介绍 WD4 与 BPM 集成 
的 开发 配置 过 程 。 以 请 假 申请 为 例 ， 该 流程 为 二 级 审批 ， 其 中 一 级 为 部 门 领导 ， 二 级 为 公司 
领导 ， 根 据 流程 审批 级 次 建立 流程 模型 以 及 必要 的 Web Dynpro 开发 。 

简要 的 开发 流程 如 下 : 

1) 创建 流程 开发 组 件 ， 设 计 流程 模型 并 定义 流程 任务 。 

2) 创建 WD4J MEH, 定义 上 下 文 及 流程 流转 触发 事件 ， 并 与 BPM 流程 进行 关联 。 

3) 在 BPM 流程 中 对 流程 内 部 的 上 下 文 映 射 进行 定义 和 配置 。 

4) 对 BPM 流程 的 启动 方式 进行 具体 配置 和 调用 开发 。 

5) 部 署 BPM 和 Web Dynpro 项目， 运行 并 测试 流程 ， 确 认 流 转 和 处理 是 否 正确 。 


7.4.1 创建 BPM 流程 


1) 打开 开发 工具 NWDS， 选 择 “File” 一 “New” 一 “Project”( 见 图 7-39) ， 创 建 一 
个 工程 ， 或 单 击 “ 新 建 项 目 ”按钮 。 


File Edit Navigate Search Project Run 
Alt-+Shift+N > 


[C3 Folder 
EE Sis 
Ctr HSNI. 


=) Untitled Text File 


Girls 


Gerl+-Shitt+-S 
图 7-39 创建 项 目的 菜单 选择 
2) 在 弹出 的 对 话 框 中 ， 选 择 流 程 模型 类 型 的 开发 组 件 ， 并 单 击 “Next” 按 钮 ， 如 图 7-40 


所 示 。 
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3) 随后 选择 本 地 的 软件 组 件 目录 ， 选 中 “MyComponents”， 并 单 击 “Next” 按 钮 ， 如 
图 7-41 所 示 。 


| Select a wizard 


Wizards: 
type filter text 


> @ JPA 
> @ Plug-in Development 
> © Portal Application 
4 @ Process Composer 

ps Process Composer Development Component| 
> © Rules Composer 
> @ Service Composer 
> & UME 
> @ Visual Composer d Select Software Component 
> & Web 


Wait while the settings for software component 'MyComponents' 
are refreshed... 


| 
| 4 LocalDevelopment 
® =k | a 


| 84 MyComponents [demo.sap.com] | 


图 7-40 ”选择 项 目 类 型 图 7-41 选择 本 地 组 件 


4) 在 弹出 的 对 话 框 中 输入 工程 名 称 ， 并 单 击 “Next” 按 钮 ， 如 图 7-42 所 示 。 
5) 配置 项 目 公共 部 分 ,使 用 默认 配置 即 可 ， 单 击 “Finish” 按 钮 完成 项 目的 创建 ， 如 
图 7-43 所 示 。 


New Process 


New Development Component = 
New Process 
Create New Development Component (Project) 


Project Properties 


Vendor: |demo.sap.com Æ Specify additional properties for the project 
Name: i X | mybpm01 

Caption: Create Public Part for Assembly 
Language: [American Enalish -| V] Create Public Part for Compilation 
Domain: [Basis X | 

Support Component: | 


(For Example BC-DWB-FOO) 
[7] Keep DC Local for Now (Use 'Add to Source Control' Later) 


Preferences 


Q) | < Back | Next > | | Finish ] | Cancel O) 


图 7-42 输入 项 目 信 ) 


证 


图 7-43 ”选择 创建 公共 部 分 


6) 创建 完成 后 ， 就 能 在 项 目 浏 览 器 中 看 到 整个 工程 的 完整 目录 结构 ， 如 图 7-44 
所 示 。 

7) JEFF “Process Modeling”， 随 后 右 击 “Processes”， 在 弹出 的 快捷 菜单 中 选择 “New 
Process” 进行 流程 的 创建 ， 如 图 7-45 所 示 。 

8) 在 弹出 的 对 话 框 中 输入 流程 的 名 称 “VacationReqPro”， 勾 选 创 建 一 个 流程 池 并 输入 
名 称 “VacationReqPool” 和 泳 道 名 称 “Dept”， 其 他 使 用 默认 设置 ， 随 后 单 击 “Next” 按 钮 ， 
如 图 7-46 所 示 。 

9) 选择 “New”， 创 建 一 个 新 的 流程 启动 触发 器 ， 如 网 7-47 所 示 。 
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| |} [LocalDevelopment] mybpm01| 
> & Connectivity 
4 DD Process Modeling 
> 6 Processes 
@ Tasks 
> @ Event Triggers 
> GJ Reporting Data Sources 


> @ Rule Sets 

> @ Functions 

> @ Data Types 4 DD Process Modeling | 

> (@ Service Interfaces EŠ Processes| 

> @ Operation Mappings (PI) |£ Importing BPMN 2.0 diagram... 
> © sre > QB New Process  — 


图 7-44 创建 后 的 目录 结构 图 7-45 创建 流程 的 菜单 选择 


New Process 
Create a new process. 


Name: VacationRegPro 


Documentation: 


Orientation: | @ Top to Bottom © Left to Right 


FB New Process — ii 
一 一 


New Pool: V] Create a pool with the following name and lanes: 


Name: VacationReqPool | New Process 


Create process events 
Lanes: Dept 中 


‘separate lane names with commas) j 
3 ~ op ; Create start and end event from the selected trigger 
Project: |[LocalDevelopment] mybpm01 =| New... à 5 
F Trigger: DefaultService_Empty 
Language: English 


(defined by project) 


DefaultService_Empty 
四 | | Cancel DefaultService_EmptyAsync 


图 7-46 创建 新 流程 图 7-47 流程 启动 触发 器 


10) 在 弹出 的 对 话 框 中 输入 触发 器 的 名 称 “StMes”， 随 后 单 击 “Next” 按 钮 ， 如 图 7-48 
所 示 。 


11) 服务 接口 选择 默认 接口 ， 随 后 单 击 “Finish” 按 钮 完成 触发 器 的 创建 ， 如 图 7-49 
TIAN o 


New Messa = New Messa = 


New Message Trigger New Message Trigger 


Create a new Message Trigger Select operation 


Name: StMes Define properties such as service interface and operation: 
Documentation: Service [Defaultservice| sé 
Operation: ‘Empty (In:Empty, Out:EmptyResponse) -| 


Endpoint Name http://<hostname=:<port>/bpm/demosapcom/mybpm01/StMes 
Language: English (Defined at DC level) 


© < Back Next> || Finish |[ Cancel @ (sad Next > Einish Cancel 


T 


图 7-48 输入 触发 器 信息 图 7-49 输出 触发 器 运行 事件 


12) 单 击 “Finish” 按 钮 ， 完 成 流程 的 创建 ， 如 图 7-50 所 示 。 
13) 在 右 侧 的 模型 编辑 器 中 可 以 看 到 创建 完毕 的 休假 申请 空 流程 ， 如 图 7-51 所 示 。 
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New Process 


e 
New Process 


Create process events 


VacationReqPool 


| 
event from the selected trigger 


© Next | Finish | | Cancel | 
图 7-50 ”选择 触发 器 


图 7-51 流程 建 模 
14) 将 鼠标 悬 停 在 标题 上 ， 单 击 弹出 的 “创建 泳 道 "， 如 图 7-52 所 示 。 
15) 输入 泳 道 名 称 “Com” 代表 公司 审批 阶段 ， 如 图 7-53 所 示 。 


fa 
& VacationReqPool E] 
Create Lane & Vacation Rene eo 
Create Lane Dept E 
图 7-52 ”弹出 菜单 


图 7-53 ”创建 新 泳 道 
16) 选中 流程 中 的 “Start” 至 “End” 的 连 线 (选中 有 高 亮 显 示 ) ， 删 除 ， 
所 示 。 


如 图 7-54 
17) 将 鼠标 悬 停 在 开始 事件 上 ， 并 选择 创建 一 个 用 户 动 作 ， 如 图 7-55 所 示 。 


& VacationReqPool 
Dept Com 
(©) ê VacationReaPoo! 
start -Dent 
! Li E 
©? 
1 
| sat 
! 0,9, 
: 4 O Activity 
© | Sua Human 
ang $ Automated 


& Notification 


图 7-54” 建 模 操 作 


图 7-55 创建 用 户 动作 

18) 完成 动作 创建 后 ,编辑 器 中 将 出 现 对 应 的 图 形 ， 如 图 7-56 所 示 。 

19) 接着 将 鼠标 悬 停 在 用 户 动作 结 点 并 添加 网 关 ， 用 于 判断 流程 走向 。 选 择 “Exclusive 
Choice”, WIBI 7-57 所 示 。 

20) BEA RNASE, ARSE GEES TI APE, FR Se He Be BS 


司 审批 的 泳 道中 。 虽 然 泳 道 并 没有 对 代码 或 配置 产生 任何 影响 ， 但 是 明细 的 泳 道 划 分 有 利于 
后 期 的 修改 及 运 维 管理 ， 如 图 7-58 所 示 。 
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© |& Exclusive Choice 

© End Ê Event-Based Choice 
End & Parallel Split 

图 7-56 ”创建 用 户 动作 图 7-57 创建 网 关 的 菜单 选择 


Com 


7-58 创建 新 的 用 户 动 作 


21) 接着 在 二 级 审批 的 基础 上 继续 创建 网 关 “Exclusive Choice 1”， 随 后 再 创建 一 个 发 
起 人 处 理 结 点 “Human3”， 如 图 7-59 所 示 。 


Alternativet 


7-59 ERRE 


22) 在 “Human3” 结 点 基础 上 ， 单 击 连 线 并 拖 忠 至 “Humanl1” 结 点 ， 建 立 发 起 人 结 
点 到 一 级 审批 的 联系 ， 如 图 7-60 所 示 。 
23) 整个 流程 模型 构建 完毕 ， 进 一 步 修 改 结 点 描述 。 通 过 流程 图 可 以 看 出 ， 该 流程 为 二 


级 审批 ， 申 请 人 提交 后 直接 进入 一 级 审批 ， 一 级 审批 通过 则 到 二 级 审批 ， 二 级 审批 通过 流程 结 
R, 一 级 和 二 级 拒绝 都 会 驶 回 到 申请 人 ， 申 请 人 重新 提交 并 再 次 到 一 级 审批 ， 如 图 7-61 所 示 。 
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四 
Exclusive 


Choice0 


Alternative2 


Exclusive Choice 1 
Alternativet 


7-60 创建 联系 


VacationReqPool 


7-61 流程 示例 


24) 接着 创建 流程 中 的 任务 ， 右 击 “Tasks” 文 件 来， 选择 “NewTask”， 创 建 一 个 新 的 


任务 ， 如 图 7-62 所 示 。 


25) 输入 任务 名 称 ， 随 后 单 击 “Finish” 按钮 ， 如 图 7-63 所 示 。 


Alp Connectivity 
-DD Process Modeling 
| BG Processes 

B 


7-62 BJEK NSA 


ETE 


New Task 


New Task 


Create a new task 


Name: ReqTask 


Documentation: 


Generate UI Component 
Language: English 


(Defined at DC level) 


O) < Back Next > Finish Cancel 
图 7-63 输入 任务 信息 
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26) 按照 同样 的 操作 ， 分 别 建立 DeptTask , ComTask 和 ReqTask, 3 个 任务 分 别 对 应 流 
程 中 的 3 个 用 户 动 作 ， 如 图 7-64 所 示 。 

27) 接着 选中 第 一 个 用 户 动 作 “ 一 级 审批 ”， 在 下 方 属 性 的 页 签 中 ， 找 到 “Task” 子 
标签 ， 在 其 中 选择 对 应 的 任务 “DeptTask”， 表 示 部 门 审 批 环境 。 用 同样 的 方法 将 “二 级 


审批 ”的 任务 选择 为 “ComTask”， 将 “申请 人 ”的 任务 选择 为 “ReqTask”， 如 图 7-65 
所 示 。 


一 级 审批 
Generel Assign a task to the human — 
Looping flask DeptTask | 


Task 


v Override Task Settings 

Input Mapping Override individual task settings for the task a: 
ies ie ce further options in the navigation. 

-DD Process Modeling p spe:28. 


o Bo nr Tecate 口 Priority 口 Activation time 
H-E Processes DY es | ， ; 
: 2 ae O Potential owners [] Start deadline 
5 asks 
因 ConTask [C Excluded owners [] Completion deadline 
| |! A DeptTask o Expiration time 
A ReqTask 


图 7-64 创建 后 的 目录 结构 图 7-65 在 用 户 动作 中 选择 对 应 任务 


7.4.2 关联 WD4J 项 目 


TE Web Dynpro 工程 中 ， 只 有 接口 视图 和 接口 控制 器 是 对 外 可 见 的 。 对 于 BPM 流程 中 的 
任务 界面 定义 ， 需 要 进行 绑 定 的 就 是 Web Dynpro 中 的 接口 视图 。 

开发 实例 : 

1) 首先 创建 一 个 Web Dynpro 工程 ,选择 “File” 一 “New” 一 “Project”( 见 图 7-66 ) ， 
或 单 击 新 建 项 目 按钮 。 

2) 在 弹出 的 对 话 框 中 选择 对 应 的 项 目 类 型 ， 找 到 “Web Dynpro Development Compo- 
nent” Mi “Next” 按钮 ， 如 图 7-67 所 示 。 


|| Select a wizard 


File Edit Navigate Search Project Run 


Create a new Web Dynpro development component 


~ Open File... = Wizards: 
F ar [5 Folder wich 
Glose GEIEN S pil 
s File = 
Close all Cr opift Wy 4 & Web 


= Untitled Text File 


T$ Dynamic Web Project 
JÌ Static Web Project 
4 @ Web Dynpro 


BB seve EHS 
E save is., 


. Save Al Gbrl Shires 


FE? Example... 


S Web Dynpro Development Component 


fj Other... 


图 7-66 创建 项 目的 菜单 选择 


BS 


7-67 选择 项 目 类 型 


3) 选择 本 地 的 开发 架构 中 的 “MyComponents”， 单 击 “Next” 按 钮 ， 如 图 7-68 
所 示 。 


4) 输入 工程 名 称 “mydynp08”， 单 击 “Next” 按 钮 ， 如 图 7-69 所 示 。 
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New Development Component 


Create New Development Component (Project) 


Vendor: demo.sap.com 
Name: 7 mydynpo 引 
Select Software Component = z 

Caption: 

Select the software component where you want to crea | 

settings for the selected component will be refreshed | Language: [American English 

a QB LocalDevelopment | Domain: [Basis 
| g MyComponents [demo.sap.com] | Support Component: 
| 


(For Example BC-DWB-FOO) 


Al 7-68 选择 本 地 开发 组 件 图 7-69 输入 项 目 信息 


way 


5) 展开 创建 后 的 Web Dynpro TIE, Ai “Components” Ff 6 (Genesee! —— 
FE “Create Component”， 创 建 一 个 组 件 ， 如 图 7-70 所 示 。 attests 

6) 输入 组 件 名 称 “ Dynp08_01 Comp” 单 击 “Next” 按钮 ， 如 7-70 ”创建 组 件 的 
图 7-71 所 示 。 aes 

7) 输入 对 应 的 窗口 名 称 “Dynp08_01CompWindow” 和 接口 视图 名 称 “Dynp08_01Comp 
_01InterV”， 单 击 “Finish” 按 钮 ， 如 图 7-72 所 示 。 


| | 加 New Component 


Specify Component Properties 


Specify Window Properties 
Enter name and package for the new Web Dynpro Component Enter the name for the default Window and Interface View. Specify new 


| View(s) to embed into the Window. 


Component Name — Dynp08_01Comp| 


Component Package com.sap.demo.mydynp08.wd.comp.dynp08_01) | Browsen. 


Window Name Dynp08_01CompWindow 


Interface View 
Choose additional capabilities for the new component 


Interface View Dynp08_01Comp_OlInterV 
[7] Default Wind d Vi ni 
lV Default Window and Views [V] Create Startup Plug (for Application reference) 
回 Used Models 


[E] Implemented Interfaces Embed Views 


Name Embed Default Add. 


Dynp08_01CompView 


= (oni Conte (ec Ne 


图 7-71 输入 组 件 信息 图 7-72 输入 窗口 和 视图 信息 


8) 默认 创建 的 接口 视图 作为 流程 发 起 时 申请 人 操作 的 对 应 页 面 ， 接 着 再 创建 两 个 接口 


视图 “Dynp08_01Comp_02InterV” 和 “Dynp08_01Comp_03InterV” 做 为 一 级 审批 与 二 级 审批 
的 任务 页 面 ， 如 图 7-73 所 示 。 


9) 在 新 建 的 接口 视图 中 ， 需 手动 创建 一 个 类 型 为 “Startup” 的 Inbound Plug 作为 默认 
入 口 ， 如 图 7-74 所 示 。 


10) 在 创建 两 个 接口 视图 后 ， 还 需要 创建 两 个 窗口 “Dynp08 _02CompWindow” 和 


“Dynp08_03CompWindow”， 用 于 实现 新 建 的 接口 视图 ， 如 图 7-75 所 示 。 接 口 视图 要 与 窗口 
一 一 对 应 。 


11) 同时 要 保证 3 个 窗口 的 “接口 视图 ”属性 中 都 已 实现 了 对 应 的 接口 视图 ， 如 
图 7-76 所 示 。 
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v Inbound Plugs 


昌国 Local Component Interface Displays the inbound plugs 
Inherited Interfaces 


tes 
= 


<8 Interface Controller 
=) Interface Views 
E Dynp08_01Comp_01Inter¥ 
E Dynp08_01Comp_02Inter¥ 
E Dynp08_01Comp_03Inter¥ 


E Windows 
Z Dynp08_01Compitindow 
E Dynp08_02Comptindow 
门 Dynp03_03Compiindow 


图 7-73 创建 后 的 目录 结构 图 7-74 创建 的 入 口 图 7-75 创建 对 应 窗口 
12) 编辑 申请 人 操作 的 视图 ， 创建 上 下 文 结 点 及 相关 属性 ， 如 图 7-77 所 示 。 


O Dynp08_01CompWindow 


General Interface View Fea 


References 


> V- 
eas E] Dynp08_01Comp_O1inter' 


Methods 
Event Handlers 


Plugs | 


Interface Views | 


Miscellaneous | 


图 7-76 实现 对 应 接口 视图 图 7-77 上 下 文清 单 


13) 通过 表单 的 模板 向 导 自 动 生成 请 假 申 请 的 页 面 ， 并 添加 提交 按钮 ， 如 图 7-78 所 示 。 

14) 使 用 相同 的 上 下 文 以 及 视图 元 素 创 建 男 外 两 个 视图 ， 但 在 审批 页 面 中 需 添 加 “ 通 
过 ”与 “拒绝 ”两 个 按钮 用 于 触发 BPM 流程 的 流转 ， 同 时 页 面 元 素 属 性 均 修改 为 只 读 ， 如 
图 7-79 所 示 。 


Bate 请 假 申请 
申请 单 号 : |@reqNo SERS: @reqNo 
BBA: |@reqid BBA: @reald 
姓名 {@reqName 姓名 @reqName 
审 请 日 期 : [@reqDate M SROs: @reqDate F 
RA: [@reason Fe @reason 
a Ekg 拒绝 
Vs 2 a 
图 7-78 预览 效果 图 7-79 运行 效果 


需要 注意 的 是 ， 由 于 现在 是 基于 BPM 进行 开发 ， 每 个 Web Dynpro 的 视图 都 是 被 BPM 
流程 中 一 个 独立 的 任务 所 调用 并 展示 ， 通 过 BPM 的 流程 分 别 将 不 同 的 待 办 任务 推送 给 用 户 ， 
因此 并 不 存在 Web Dynpro 中 的 页 面 切换 动作 ， 之 前 页 面 的 元 素 中 绑 定 的 上 下 文 也 就 不 需要 
与 组 件 控制 器 中 的 上 下 文 做 映射 。 


15) 接着 创建 组 件 控制 器 中 的 上 下 文 ， 这 个 上 下 文 是 用 于 提供 。 ORS 
给 BPM 流程 进行 流程 上 下 文 映 射 、 网 关 判 断 逻 辑 、 任 务 审批 人 、 ee 
任务 标题 等 内 容 的 配置 。 创 建 存放 数据 的 对 应 结 点 : ProcessNode、 oh eee 


BusiData, Reservl Node, Reserv2Node 和 Reserv3Node, 4 Kl 7-80 
所 示 。 其 中 “ProcessNode” 的 集合 属性 是 “1 .. 1”， 因 为 每 次 用 
户 仅 提交 一 份 表单 。 

16) 其 中 “BusiData” 包 含 了 具体 的 业务 数据 特性 ， 集 合 属性 是 “1 .. 1”， 如 图 7-81 
所 示 。 

17) 其 余 3 个 结 点 用 于 作为 预 留 字段 ， 避 免 接口 频繁 更 改 带 来 的 麻烦 ， 集 合 属性 是 “1 
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7-80 上 下 文 结 点 清单 


-+n”, WA 7-82 所 示 。 
18) 接着 右 击 并 复制 组 件 控 制 器 中 的 上 下 文 ， 打开 Web Dynpro 的 接口 控制 器 并 粘贴 ， 
完成 上 下 文 结 点 对 外 声明 的 动作 ， 如 图 7-83 所 示 。 


FL) Busidata 

bukrs 
gatelay 
metAutold 
nextApprPers 


poolName 
processCode 
procNunber 
roadMapStr 
startUser 
startUserDep 
taskame 
taskWode 
taskiumber 
transacCode 
yuliul 
yuliu2 
yuliu3 
yuliud 
yalinS 


图 7-81 YEWA 图 7-82 ”特性 清单 图 7-83 ”上下文 清单 
19) 在 组 件 控制 器 中 创建 一 个 名 称 为 “finish” 的 自 定义 事件 (Events) ， 将 该 事件 复制 
并 粘贴 至 接口 控制 器 中 ， 如 图 7-84 所 示 。 
20) 创建 一 个 自 定 义 方 法 用 于 处 理事 件 ， 不 需要 定义 参数 ， 如 图 7-85 所 示 。 


回回 回回 回回 加 加 加 加 加 印加 田 田 加 色目 四 


oa 


< Component Controller “@ Component Controller 
General eo General 
References type filter text Zz References $ = 
Context Context 
& finish ous type filter text 

Methods Methods — = 
Event Handlers Event Handlers Dh ddotioish wid 
Events Events 

At yy He fF Pty y 

7-84 ” 自 定义 事件 Al7-85 ” 自 定 义 方法 


21) 保存 所 有 修改 后 ， 进 入 Java 编辑 器 ， 添 加 事件 的 触 
发 代码 : 


“& Dynp08_01CompInterface 


General ps 
References 
public void finish( ) | — type = 
//@ @ begin finish( ) wane 8 finish 
wdThis. wdFireEventFinish( ) ; Events 
//@ @ end 


图 7-86” 自 定义 事件 


22) 将 事件 复制 并 粘贴 至 接口 控制 器 中 ， 如 图 7-86 所 示 。 
23) 在 申请 人 视图 的 “提交 ”按钮 的 动作 中 添加 代码 : 


// 获 取 流程 流水 号 并 根据 流水 号 判断 是 否 在 流程 中 
IPublicDynp08_01 Comp wdGetDynp08 _01CompController = wdThis. wdGetDynp08 _01 CompController 


he 
String procNumber = wdGetDynp08 _ 01CompController. wdGetContext ( ) .nodeBusiData ( ) 


. currentBusiDataElement( ). getProcNumber( ) ; 


if( procNumber == null || procNumber. length( ) ==0) | 
// 启 动 流 程 
/产生 流程 号 
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procNumber = "000001" ; 
// 保 存单 据 至 数据 库 
// 调 用 标准 API 发 起 流程 
this. startProcess( wdContext. current VacationReqElement( ). getReqNo( ), procNumber) ; 
| else | 
// 直 接 进 入 一 级 审批 
currentBusiDataElement. setTaskName(" 请 假 申 请 一 级 审批 " )，; 
wdGetDynp08_01CompController. doFinish( ) ; 
| 


24) 在 审批 人 视图 的 “提交 ”按钮 的 动作 中 添加 代码 : 


[PublicDynp08_01Comp wdGetDynp08 _01CompController = wdThis. wdGetDynp08 _01 CompController 
OF 

IBusiDataElement currentBusiDataklement = wdGetDynp08 _ 01CompController. wdGetContext ( ) 
. nodeBusiData( ). currentBusiDataElement( ) ; 

String taskNode = currentBusiDataElement. getTaskNode( ) ; 

if( "20". equalsIgnoreCase(taskNode) ) | 

// 一 级 通过 

currentBusiDataElement. setTaskNode( "30" ) ;// 设 置 下 一 结 点 为 30 

currentBusiDataElement. setTaskName( "请假 申请 二 级 审批 " ) ; 

| else if( "30". equalslgnoreCase( task Node) ) | 

// 流 程 结束 

| 

// 触 发 监听 event 

wdGetDynp08_01CompController. doFinish( ) ; 


25) 在 审批 人 视图 的 “拒绝 ”按钮 的 动作 中 添加 代码 : 


[PublicDynp08_01Comp wdGetDynp08 _01CompController = wdThis. wdGetDynp08 _01 CompController 
Oe 

IBusiDataElement currentBusiDataklement = wdGetDynp08 _ 01CompController. wdGetContext ( ) 
. nodeBusiData( ). currentBusiDataElement( ) ; 

String taskNode = currentBusiDataElement. getTaskNode( ) ; 

if( "20". equalsIgnoreCase(taskNode) ) | 

// 一 级 拒绝 

currentBusiDataElement. setTaskName(" 请 假 申 请 一 级 驶 回 " ) ; 

| else if( "30". equalslgnoreCase(taskNode) ) | 
// 二 级 拒绝 
currentBusiDataElement. setTaskName(" 请 假 申 请 二 级 驶 回 " ) ; 

| 

currentBusiDataElement. setTaskNode( "10" ) ;设置 下 一 结 点 为 10 
// 触 发 监听 event 

wdGetDynp08_01CompController. doFinish( ) ; 


部 分 ， 输入 名 称 “ 随后 单 击 “Finish” 按 钮 ， 如 图 7-88 


26) 右 击 “Dynp08_01Comp"， 在 弹出 的 快捷 菜单 中 选择 [3 
“ Add to Public Part”， 如 图 7-87 所 示 。 , oes bai eae 
27) 在 弹出 中 单 击 New” 按钮 ， 创建 一 个 公共 X Delete 
Copy 


A 7-87 添加 公共 部 分 


ai 完成 公共 部 分 创建 后 ， 单 击 “Finish” 按 钮 ， 如 oe 
EI 7-89 所 示 。 


m= = 一 一 > 5 dl 
EEC e 


| Public Part | Public Parts of 'mydynp08 [demo.sap.com]' et 
Enter the public part name and select a purpose. You can also enter a at Select a Public Part oS 
caption and description. 


Name: apil 


Purpose: COMPILATION X 


Caption: 


Description: ` 


| Finish | | Cancel 


7-88 输入 公共 部 分 信息 从 部 分 
29) 通过 开发 工具 的 视图 切换 按钮 ， 切 换 至 “Development Infrastructure”， 如 图 7-90 
所 示 。 
30) 在 左 侧 的 “MyComponents” 中 选择 BPM 工程 “mybpm01”， 在 右 侧 属性 中 打开 
“Dependencies” 依赖 标签 ， 单 击 “Add” 按 钮 添加 依赖 ， 如 图 7-91 bee, 


Es 
了 
Oo 
O 
& 
R 
> 
| 


& Java 

I SAP Management Console 4 g LocalDevelopment 

Ee] Development Infrastructure E g MyComponents [demo.sap.com] 
yi Web Dynpro ye mydynp08 

图 7-90 切换 透视 图 图 7-91 添加 项 目 依赖 


31) 添加 后 ， 保 存 所 有 修改 ， 并 编译 两 个 工程 ， 如 图 7-92 所 示 。 
32) 在 完成 Web Dynpro 工程 的 开发 与 配置 后 ， 重 新 进入 BPM 流程 编辑 视图 ， 打 开 流 程 
中 的 任务 ， 切 换 到 “Overview”， 如 图 7-93 所 示 。 


Required DCs 
Specify the list of DCs required for this DC 


Da bie/sca/scdl/contributors/ glx AA 
Sq bie/sca/scdl/contributors/me 
Da bie/sca/sedl/gen 

Da bie/sca/sedl/gen/me 

Da bie/sca/scdl/gen/xlf2prop 
Dei de/es/congis/ne/nodel/bi 


Da te/bpem/content/predefs/ default 

Da te/bpem/content/predefs/types 

Da tefmoin/bi/model/textverticalization 
Da tefmoin/bifmoinext 

Da tefmoin/bi/moinlibs 


~ User Interface 


2h oo oe ee 


Define the UI component you want to use to execute instances of this task 


Component: 


图 7-92 添加 项 目 依赖 图 7-93 48% Web Dynpro 工程 界面 


33) 单 击 “User Interface”， 选 中 组 件 右 侧 的 “Choose” 单 选 按钮 ， 在 弹出 的 对 话 框 选 
择 默认 选项 ， 随 后 单 击 “OK” 按 钮 ， 如 图 7-94 所 示 。 

34) 单 击 “Search” 按 钮 ， 搜 索 可 用 的 Web Dynpro 工程 公共 部 分 ， 选 择 对 应 的 接口 视 
图 ， 随 后 单 击 “Next” 按 钮 ， 如 图 7-95 所 示 。 

35) 选择 视图 按钮 对 应 触发 的 事件 ， 将 BPM 中 的 流程 流转 动作 与 Web Dynpro 中 的 事件 
绑 定 ， 如 图 7-96 所 示 。 

36) 完成 BPM 中 任务 与 Web Dynpro 接口 视图 的 绑 定 ， 如 图 7-97 所 示 。 
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MUI Technology 
@ Web Dynpro Java Qocal to workspace) 
C Visual Composer Qocal to workspace) 


(© Web Dynpro ABAP CHIP from: | server 


m Choose UI Component 二 

Ho] Dynp08_01Comp [Dynp08_01Comp_01Intery] - demo. sap. com/myd 
Hc) Dynp08_01Comp [Dynp08_01Comp_02Inter¥] - demo. sap. com/myd 
Hc) DynpOS_01Comp (Dynp08_O1Comp_O3Inter¥] - demo. sap. com/myd 


Type 
|Online Technologies (Web Dynpro Java, Web Dynpro ABAP) 
Offline Technologies (Adobe Forms) 


加 


IV Show supported components only 


Custom Technologies 


图 7-94 选择 对 应 类 型 图 7-95 选择 对 应 组 件 


User Interface 


Selected Component: Define the UI component you want to use to execute instances of this task 一 
ee 


Completion Event: = 
Component: Dynp08_01Comp[Dynp08_01Comp_OlInter¥] - demo. sap. com/mydynp08 


rror Events (Optional): [wane | 
Type: Web Dynpro Java 


图 7-96 选择 对 应 事件 图 7-97 ”配置 完成 后 的 界面 


7.4.3 有 映射 流程 上 下 文 

1) 在 上 一 节 中 ， 完 成 了 BPM 中 的 流程 流转 动作 与 Web Dynpro 中 的 事件 绑 定 。 而 同时 
在 BPM 工程 的 数据 类 型 中 也 完成 了 对 Web Dynpro 上 下 文 的 引用 ， 展 开 BPM 工程 目录 中 的 
“Data Types” 就 能 看 到 引用 的 结果 ， 如 图 7-98 所 示 。 

2) 将 上 下 文 的 根 结 点 结构 “Context” 拖 忠 至 右 侧 模型 编辑 器 中 ， 生 成 了 “DO_Con- 
text” 的 流程 上 下 文 对 象 ， 即 完成 了 流程 上 下 文 的 声明 。 完 成 上 下 文 定义 后 ， 需 要 完成 流程 
上 下 文 映 射 、 网 关 判 断 逻 辑 、 任 务 审批 人 、 任 务 标题 的 配置 ， 如 图 7-99 所 示 。 


Dept Com 


\D0_co ntet / 
SS 


C Data Types 
Sees} http, ffdemo. sap. com/mydynp08/Dynp08_01Comp 


E c cessNode 

[E] Context “ProcessNode_BusiData 
[E] Context_ProcessNode_ReserviNode 
图 

E 


四 
ExclusiveChoice1 


L-E] Context_ProcessWode_Reserv2Node Appr 


Context_ProcessNode_Reserv3Node 
G-E} http: /fdemo. sap. com/mydynp08/Dynp08_01Comp/ 
四 -EE XSD Files 


7-98 绑 定 Web Dynpro 项 目 后 的 效果 图 7-99 生成 “DO_Context” 对 象 


3) 接着 选中 用 户 动作 ， 打 开 下 方 的 “Input” 页 签 ， 完 成 从 左 侧 流 程 上 下 文 到 右 侧 流 
任务 所 需 上 下 文 的 映射 ， 如 图 7-100 所 示 。 

4) 打开 下 方 的 “Output” 页 签 ， 完成 从 左 侧 流程 任务 输出 的 上 下 文 到 右 侧 流 程 上 下 文 
的 上 映射， 如 图 7-101 所 示 。 

5) 按照 同样 的 操作 ， 将 其 余 的 用 户 动 作 结 点 进行 上 下 文 映射 。 参 考 Web Dynpro 开发 模 
ah 可 以 将 “DO_Context” 流 程 上 下 文 对 象 想象 成 Web Dynpro 中 的 组 件 控制 器 ， 工作 流 中 
的 数据 流转 都 需要 通过 “DO_Context” 进 行 同步 ， 但 与 组 件 控 制 右 不 同 的 是 , “DO_Context” 
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AAR Boi re MBO RE 


一 级 审批 
Define the input mapping for this element: 

General = att — P = 
—— | |Process context Inputs of RERE 
Looping R R 
= 2% = =H 
Input Mapping 日 - 国 ProcessNode 一 、 *E-[E] UTRequest 
Output Mapping 由 - 国 BusiDate — 日 - 国 Context 
Boundary Events HE ReserviNode E-E ProcessNode 

HHE] Reserv2Node 

(EE) Reserv3Node 


图 7-100 流程 上 下 文 映 射 1 


© 一 级 市 批 
a Define the output mapping for this element: 
TT Outputs of 一 级 审批 ans Process context _ 
— 一 |e l |E 
5 R DO_Context 5 E- D0 Context 

etapat MapPAnE I) | G taskutput Z 日 - 国 ProcessNode 
Output Mapping H-E ExeludedOwners Pá H-E BusiData 
Boundary Events 由 - 国 Potential0wners / (QE) ReservlNode 

EE] TaskAttributes WA BEES Reserv2Node 

白 - 国 WIResponse PA H-E Reserv3Node 

日 -是 ee" 
H-E] ProcessNode 


图 7-101 流程 上 下 文 映 射 2 


6) 接着 进行 网 关 判 断 的 定义 。 选 中 流程 中 的 网 关 ， 色 选 “refuse” 为 默认 的 ， 接 着 选 
择 “Appr” 并 单 击 “Edit” 按 钮 ， 打 开 条 件 编辑 ， 如 图 7-102 所 示 。 


Define the condition evaluation order for this gateway. Condition for default gate is not evaluated. 


0.. | Name Condition Default Gate 
1 Appr <no condition> E e] 


ss tal 
Edit 


7-102 ”修改 网 关 判 断 条 件 


7) 根据 设计 ， 当 上 下 文中 的 “tasknode” 特 性 值 为 “30” 时 ， 代 表 审 核 通 过 并 到 二 级 
审批 步骤 ， 默 认为 拒绝 。 条 件 表达 式 的 关键 字 可 以 从 右 侧 的 清单 中 选择 ， 也 可 以 手动 编写 ， 
如 图 7-103 所 示 。 输 入 对 应 条 件 表 达 式 


string — equal ( DO_Context/ProcessNode/BusiData/ taskNode ," 30" ) 


@Condition Expression xj 


SOs tring-equal MO Context/P sNode/BusiData/taskWode, “30") Eeter filter text 


T] string( boolean value ) af 
string( dateTime value | | 


string( decimal value ) 
string( double value ) 
string( integer value ) 


string( long value ) 
string-equal ( string le: 
string-greater-equal ( s- 


string-greater-than( stiv 
4| | LAL) 
| 


Details | 
Source [E] Java - sap. com/bpem/elx/bui | 

n Zi Type [E] boolean - http://www. w3. org | 
J 


4 


@Extract Function... 


® 


图 7-103 ”修改 网 关 判 断 条 件 表 达 式 
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8) 使 用 同样 的 方式 设置 二 级 审批 的 网 关 判 断 


条 件 。 


9) 接着 选中 任务 ， 切 换 至 “Roles” 角 色 页 签 ， 
选中 “Use an expression” 单 选 按钮 ， 随 后 单 击 “Ed- 


it” 按 钮 ， 如 图 7-104 所 示 。 
10) 表达 式 的 关键 字 与 网 关 逻 辑 判断 时 一 样 ， 
审批 人 通过 上 下 文中 的 “nextApprPers” 传 递 ， 如 


图 7-105 所 示 。 


Roles 


Potential Owners 
Define the default list of potential owners for this task 
© Choose one or more UME principals 


(Empty) 


@ Use an expression 


Principals: 


Expression: 


7-104 编辑 角色 所 有 者 


getPrincipal( UIRequest/ Context/ ProcessNode/ BusiData/ nextApprPers ) 


rincipal Expression 


4 


@Extract Function... 


© 


BeetPrincipal UIReguest/Conte: 


器 


7-105 


编辑 表 i 


metAutold 


a 


nextApprPers 


poolName 


processCode 


procNumber 


roadMapStr 


startUser 


startUserDept 


站 日 日 日 日 日 日 日 日 


taskHame ad 


4 | | » 
Details 
= 
> 


Type [1 


nextApprPers - http: //demo. 


string - http://www. w3. org 


11) 使 用 同样 的 方式 设置 另外 两 个 流程 任务 的 审批 人 。 


12) 接着 打开 任务 的 “User Texts” 页 签 ， 在 “Variables” 中 单 击 “Add” 按 钮 添加 一 


个 “taskName” 的 参数 ， 随 后 单 击 “Edit” 按 钮 ， 如 图 7-106 所 示 。 


13) 


v Variables 


Variable: Wane 


taskName 


图 7-106 添加 变量 


Define the variables you want to use to parameterize the user texts below 


使 用 上 下 文中 的 “taskName” 进行 传递 〈 见 如 图 7-107) ， 输 入 : 


UIRequest/ Context/ Process Node/ BusiData/ task Name 


14) 


完成 变量 创建 后 ， 接 着 在 下 方 的 任务 标题 中 输入 该 参数 ， 在 “Subject” 中 输入 
“|taskgName|”， 其 中 “ | ”表示 引用 参数 的 名 称 。 完 成 设置 后 ， 所 有 待 办 的 标题 也 可 以 通 


过 Web Dynpro 中 的 上 下 文 进行 自 定义 修改 了 ， 如 图 7-108 所 示 。 
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回 roadMepStr af 
T] startUser 

[T] startUserDept 
[T] taskWame 
taskNode 

[T] taskNanber 

T] transacCode 


T yaLiul 


yaliu2 
T mLiu3 a 


~ Parameterized Texts 


Define the texts that will be shown in the user’s inbox. 


一 
Source 。 taskName - http: //demo. sap. Subject: O{taskNamel 
m if Type [T] string - http://www. w3. org Description: 


Extract Function... 


O) 


om] ee 


图 7-107 编辑 表达 式 图 7-108 定义 任务 标题 


7.4.4 配置 启动 方式 


1) 在 “Service Interface” 服 务 接口 中 创建 流程 启动 的 Web 服务 ， 右 击 “WSDL Files” 


文件 夹 ， 选 择 “New WSDL”， 如 图 7-109 所 示 。 


2) 输入 WSDL 文件 的 名 称 “StartInter”， 随 后 单 击 “Finish” 按 钮 ， 如 图 7-110 所 示 。 


E Service Interfaces 


File name: [StartInter. wsdl 
TET WSDL. . 


Advanced >> | 
图 7-109 创建 新 的 WSDL 文件 图 7-110 输入 文件 名 


Import RFC 


3) 创建 完成 后 ， 编 辑 其 中 的 参数 。 由 于 BPM 的 Web 服务 是 异步 的 服务 ， 不 需要 即时 


响应 的 输出 ， 首 先 删除 “Output” 返 回 结构 ， 如 图 7-111 所 示 。 


4) 单 击 “Source” 源 代码 页 签 ， 输 入 其 中 与 “Response” 相 关 的 代码 ， 如 图 7-112 


所 示 。 


3 <wsdl:types> 


4 

5 <xsd:element name="NewOperation"> 
6 <xsd:complexType> 

7 <xsd:sequence> 

8 


9 </xsd:sequence> 
10) </xsd:complexType> 
11 </xsd:element> 
T 12 
Q Startinter 13 </xsd:schema> 
g NewOperation 14 </wsdl:types> 


15 <wsdl:message name="NewOperationRequest"> 


[P parameters [€] NewOperation 


Tom aa [E] NewOperationResponse i7] </wsdl :message> 


[Add Fault 
[P Add Part 19 <wsdl:portType name="StartInter"> 
Delete 20| <wsdl:operation name="NewOperation"> 
ae 21 <wsdl:input message="tns:NevwOperationRequest"/> 
Set Message 22 
Torrie 23| </wsdl:operation> 


1K?xml version="1.0" encoding="UTF-8" standalone="no"?> 
2<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns: 


<xsd:schema targetNamespace="http://wwv.example.org/StartInter/"> 


<xsd:element name="in" type="xsd:string"/> 


| <wsdl:part element} "tns:NewOperation" name="parameters"/> 


图 7-111 编辑 参数 图 7-112 添加 代码 


5) 接着 修改 WSDL 文件 的 输入 参数 结构 ， 将 Web Dynpro 生成 的 “xsd” 
件 重 命名 ， 并 导入 到 BPM 工程 的 “XSD Fles” 中 ， 如 图 7-113 所 示 。 
6) 单 击 方法 右 侧 的 箭头 ， 进 入 方法 参数 配置 的 页 面 ， 如 图 7-114 所 示 。 


上 下 文 定义 文 
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[E Data Types 
H-E http: //demo. sap. com/mydynp08/Dynp08_01Comp 
由 - 册 http: //demo. sap. com/mydynp08/Dynp0S_01Comp/port 
-EE XSD Files 
[S| rep/ui/com. sap. deno. mydynp08. wd. comp. dynp08 P NewOperaion 
~~ [B] repfui/com. sap. demo. o, mayan 08. wd. comp. dynp08_{ 

日 


@ NewWSDLFile 


| input [P parameters [E] NewOperation — 


图 7-113 导入 xsd 文件 图 7-114 ”编辑 执行 方法 


7) 删除 默认 参数 ， 右 击 “NewOperation”， E a - — 
PRU SI | QUAN 7-115 所 示 。 z EA > FAE 
8) 在 弹出 的 对 话 框 中 找到 导入 的 Web Dynpro 
上 下 文 结构 的 XSD 文件 ， 完 成 导入 ， 如 图 7-116 Pelat S a 
所 示 。 


9) 在 目录 中 选择 之 前 创建 的 “StMes” 触 发 器 ， 在 右 侧 找 到 设置 属性 并 选择 服务 接口 
“StartInter”， 如 图 7-117 所 示 。 


选 


ob 


Context_ProcessNode 
~ Settings 
© ReserviNode [0..*] Context_ProcessNode_ReserviNode 
Define properties such as service interface and operation: 
Reserv2Node [0..*] Context_ProcessNode_Reserv2Node tae 
Se SER 
el Reserv3Node [0..*] Context_ProcessNode_Reserv3Node = = 一 = 
Operati dewOperation Tn: Wevdperation, | Out: oF 
e BusiData [1..1] Context_ProcessNode_BusiData 
RZ aa Sy ~ 
7-116 ”完成 参数 创建 后 的 效果 图 7-117 触发 器 配置 


10) 随后 选中 开始 事件 ， 打 开 下 方 的 “Output” 页 签 ， 将 左 侧 开始 事件 的 传人 参数 与 右 


侧 流 程 上 下 文 进行 映射 ， 即 表示 在 流程 启动 后 随 着 Web 服务 传人 的 数据 进入 到 了 流程 上 下 
文中 ， 如 图 7-118 所 示 。 


Start 
Define the output mapping for this element: 
General tis oa 
- Outputs of Start | [Process com text 
Event Trigger B B 
Output Mappi |E |E 
utput Mappin: — 
pat wzping |S p = a 
Start Condition, H-E BusiData -一 外 -二 一 日 - 国 ProcessNode 
(FE) ReserviNode 由 - 国 BusiDate 
H-E] Reserv2Node [E ReserviNode 
由 - 国 Reserv3Node 由 - Reserv2Node 
由 -车 Reserv3Node 


图 7-118 流程 上 下 文 映射 
至 此 完成 了 BPM 的 设计 开发 过 程 。 
7.4.5 运行 测试 流程 


1) 在 完成 所 有 的 开发 配置 工作 后 ， 分 别 编译 并 部 署 Web Dynpro 工程 和 BPM 工程 。 部 署 
成 功 之 后 ， 进 入 服务 器 端的 NWA 管理 员 平 台 ， 在 菜单 目录 中 依次 找到 “Configuration” 一 


“Processes And Tasks” —> “Process Repository” 流 程 资 源 库 。 如 果 之 前 的 部 署 没 有 问题 ， 在 
流程 资源 库 中 ， 就 能 看 到 对 应 的 “mybpm01” 流 程 ， 如 图 7-119 所 示 。 


大 | Component (Vendor) 
P 


| mybpm01 (demo.sap.com) 


Last Installed Version 


20131218153350 (localDevelopment) 


图 7-119 流程 资源 库 
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2) 在 企业 门户 中 ,可 以 看 到 Web Dynpro 程序 的 默认 发 起 流程 页 面 ， 输 入 信息 并 单 击 
“提交 ”按钮 ， 启 动 流程 ， 如 图 7-120 所 示 。 

3) 使 用 一 级 审核 人 员 用 户 登 录 系 统 ， 打 开通 用 工作 清单 ， 查 看 待 办 任务 ， 如 图 7-121 
所 示 。 


ausa 通用 工作 清单 
aan = BENQ, SHR , Bax | SAPoffice 邮件 | REE 


显示 : [新 的 和 运行 中 的 任务 (212) M2s E] 


E +a 1 来 和 
z 请 候 申 请 一 级 市 批 


图 7-120 ”运行 效果 图 7-121 通用 工作 清单 界 下 


4) 单 击 任务 标题 链接 后 ， 就 会 打开 对 应 的 BPM 处 理 页 面 ,标题 也 是 通过 Web Dynpro 
中 的 代码 动态 生成 的 “请 假 申 请 一 级 审批 ” ， 如 图 7-122 所 示 。 
5) 单 击 “通过 ”按钮 ， 完 成 第 一 级 审批 ， 如 图 7-123 所 示 。 


BETA BEM 


Ee LS 
ware 


EEA — BE NE 
B erener 


Lii ne 


图 7-122 IMEI AREA 到 7-123 审批 后 提醒 消息 


wy 


6) 接着 使 用 二 级 审核 人 员 用 户 登 录 系 统 ， 打 开通 用 工作 清单 ， 查 看 待 办 任务 ， 如 
图 7-124 所 示 。 


7) 单 击 任务 标题 链接 ， 可 以 进行 二 级 审核 ， 如 图 7-125 所 示 。 


BEE ALR EH 
SANE 
通用 工作 清单 Pear ~ 
ES (2/2), Sh | BHA | SAPoffice 邮件 | ma pe 
nim 2013-12-19 
En: [新 的 和 进行 中 的 任务 (212) -多 [全 区 加 | ms reason 
SEET] x 1 oe = bes 
#eSe—asH = 
图 7-124 通用 工作 清单 界面 Al7-125 二 级 审批 界面 


7.4.6 流程 监控 


1) 使 用 管理 员 账 号 登录 NWA 平台 ， 在 菜单 中 选择 “Configuration”， 随 后 单 击 “ Proces- 
ses and Tasks” 链接 就 能 打开 流程 和 任务 的 管理 界面 ， 在 页 面 中 可 以 查看 流程 的 历史 版 本 以 
及 流程 流转 信息 ， 如 图 7-126 所 示 。 

2) 除了 监控 功能 外 ， 管 理 员 还 可 以 对 流程 做 特殊 处 理 ， 如 图 7-127 所 示 。 

3) 单 击 “Manage Processes” 链 接 ， 能 够 监控 到 新 发 起 的 流程 ， 如 图 7-128 所 示 。 

4) 通过 “Details of Process Instance” 可 以 查看 流程 的 上 下 文 和 流程 定义 ， 如 图 7-129 
所 示 。 
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Details of Component mybpm01 (demo.sap.com) and Version 20131219005942 (localDevelopment) 


Resources 


Process Flow || Start Process 


Ta Name 

P 

ComTask 
DeptTask 
ReqTask 


VacationRegPro 


图 7-126 ”流程 资源 库 中 的 任务 清单 


My Workspace | Availabilty and Performance Operations | Configuration / Troubleshooting | SOA | 


Systems | Users andAccess | Data and Databases | Jobs | 


my Z Manage Processes N //Manage Tasks ~~ 
r9 The Manage Processes application is a central area for monitoring and managing the BPM processes. Administrators can The Manage Tasks application is a central are: 
task details, deadline details, history, task ow: 


Qi 
(m view the process détails, process instance flow, process definition flow, history, process context, and so on; navigate to 
related taskS; and perform an appropriate action on a process. “navigate to the related process instance. 


Automation Wizard Administration Views, 
Helps the administrator to administer Automation wizards 


[| 


7-127 NWA 平 台中 的 流程 管理 和 任务 管理 


器 


w] | [Actions 4] | [Show Process Flow || Show Related Tasks | | | Archive... || Recover || Export Process Detail 


Show: | All Running Processes 


Go 


Find Process Instance: 


| Process Subject | Process Instance ID 


| Error Status | Status | Process Name pi 


P x 
> OK In Progress VacationRegPro Pool 0 eca993cd684811e3ac0400000048cc86 


图 7-128 查看 流程 状态 


Details of the Process Instance VacationReqPro 
Details Process Definition Administrators | History /A Context Data Error Log 


Save and Resume 


DO_Context 


Name 
v DO_Context 
v ProcessNode 


= startUserDept 
= yuLiu3 


图 7-129 查看 流程 中 的 上 下 文 


5) 选中 监控 的 流程 ， 单 击 “Show Process Flow” 按 钮 ， 如 图 7-130 所 示 。 


Manage Processes: Process Instances 


Favorites, Related Links, GoTo, Support Details EA 
5 
Show: | All Running Processes v| | [Actions 4] | [Show Process Flow || Show Related Tasks | | | Archive... || Recover || Export Process Detail | 
Find Process Instance: | Go | 
| Error Status | Status | Process Name | Process Subject | Process Instance ID 
FF 
Pool0 eca993cd684811e3ac0400000048cc86 


= OK In Progress VacationRegPro 


图 7-130 查看 流程 流转 图 
转 图 ， 根 据 上 面 流程 的 运转 情况 可 知 该 流程 处 于 二 级 审 


6) 可 以 查看 运行 时 的 流程 流 
批 ， 如 图 7-131 所 示 。 
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VacationRegPool 


Dept | Com 


DO_Context 


Appr 


7-131 标准 流程 流转 图 


7) 单 击 “Show Related Tasks”， 可 以 查看 当前 流程 实例 的 竺 办 处 理 状 态 ， 同 时 可 以 监 
控 指定 任务 的 上 下 文中 的 变量 值 ， 如 图 7-132 所 示 。 


List of Task Instances 


Show:|<Custom View> v | Actions 4 || Show Process | | Nominate Owner... || RI 
Find Task Instance: Go 
Ta Status | Lifecycle Status | Task Definition | Task Instance ID 
PF 
In Progress In Progress ComTask 45a02bb2684911e3c1ba... 
Completed Completed DeptTask ecc8804f684811e3857c0... 


7-132 ”相关 任务 实例 清单 
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第 8 FE NWA 相关 技术 


对 于 SAP NetWeaver 平台 的 开发 来 说 ，Web Dynpro 是 最 主要 的 技术 ,但 随 着 平台 不 断 的 
升级 和 功能 扩展 ， 也 逐步 兼容 和 集成 了 很 多 相关 的 成 熟 技 术 ; 在 开发 技术 拓展 的 同时 ， 
NetWeaver 平台 也 对 相应 技术 提供 了 后 台 保 障 。 简 单 来 说 ， 代 码 层 面 的 开发 交 给 Web Dyn- 
pro， 而 配置 、 运 行 和 管理 等 工作 就 交 给 了 NWA， 这 对 于 项 目 开 发 实施 的 稳定 性 以 及 用 户 体 
验 的 提升 都 起 了 非常 大 的 作用 。 本 章 将 对 NWA 管理 者 平台 、 服 务 器 实例 与 应 用 、 作 业 与 定 
时 任务 、Adobe 技术 交互 表单 、 自 定义 数据 源 等 进行 介绍 ， 并 提供 相关 开发 实例 供 大 家 
参考 。 


8.1 NWA 管理 者 平台 


从 SAP NetWeaver 平台 的 角度 来 看 ，SAP 提供 了 和 若干 管理 工具 ， 其 中 SAP NetWeaver 管 
理 者 平台 (SAP NetWeaver Administrator, NWA) 主要 用 于 在 线 的 配置 修改 和 管理 ， 而 Config 
tool 则 用 于 一 些 离线 的 配置 管理 (大 部 分 修改 后 需要 重启 服务 需 生 效 ) 。 在 SAP NetWeaver 
7.0 以 及 之 前 的 版 本 中 ， 系 统管 理 员 主 要 通过 Visual Administrator (简称 VA) 来 做 系统 配置 
管理 ， 但 在 新 版 本 的 平台 中 ，VA 管理 工具 已 集成 至 (或 升级 成 为 ) NWA, 

SAP NetWeaver 管理 者 平台 (NWA) 是 一 个 基于 网 页 端的 ， 可 提供 管理 员 进 行 管理 、 配 
置 以 及 监控 服务 器 端 内 容 的 框架 工具 。 它 由 者 干 独立 的 管理 工具 组 成 ， 可 以 用 于 管理 、 配 置 
及 监控 SAP NetWeaver 系统 、 它 的 组 件 以 及 所 有 运行 的 应 用 程序 。SAP NetWeaver 管理 者 平 
台 具有 以 下 几 个 特点 : 

1) 它 是 处 理 管理 员 任 务 的 一 个 核心 工具 ， 如 启动 或 停止 一 个 服务 需 实 例 、 修 改 配置 设 
定 、 分 析 系 统 日 志 、 分 析 报 错 信 息 并 且 确 保 所 有 系统 组 件 都 能 正常 运行 。 

2) 它 的 界面 分 类 面向 不 同 的 管理 员 任务 ， 易 于 上 手 使 用 。 

3) 它 完全 基于 网 络 运 行 ， 不 需要 在 本 地 进行 额外 的 安装 和 和 印 载 工作 。 

4) 在 不 同 界 面 提供 了 无 缝 的 链接 导航 ,方便 管理 员 进 行 不 同 操作 任务 的 跳 转 。 

5) 在 个 别处 理 界 面 中 ， 将 多 个 专家 工具 集成 在 一 起 ， 形 成 一 个 简单 、 清 晰 并 可 以 集中 
处 理 一 系列 问题 的 页 面 ， 方 便 管理 员 使 用 。 

如 需要 访问 SAP NetWeaver 管理 者 平台 ， 首 先 要 确保 服务 器 正常 运行 ， 随 后 在 浏览 器 中 
输入 下 列 地 址 : http:// <host > :<port>/nwa。 其 中 ,“host” 是 SAP NetWeaver Java 应 用 服 
务 需 的 访问 域名 ， “port” 是 对 应 的 HTTP 端口 ， 默 认 是 “5 < Java_instance_number >00”, 
一 般 在 开发 机 中 比较 常见 的 端口 即 “50000”。 

当然 访问 的 用 户 只 有 拥有 必要 的 角色 权限 ， 才 能 使 用 管理 者 平台 。 在 对 应 的 用 户 管理 中 
可 以 找到 “NWA_READONLY” 和 “NWA_SUPERADMIN” 两 个 标准 角色 ， 分 别 对 应 NWA 
的 愉 读 权限 以 及 NWA 的 超级 管理 员 权 限 (默认 管理 员 账 户 administrator EWA T EEA E 
权限 ， 可 以 直接 登录 并 使 用 ) 。 

E NWA 中 ， 所 有 核心 的 管理 员 功 能 都 被 一 一 分 类 并 放 和 不 同 的 NWA 管理 中 心 ， 包 括 
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“Operation” 运行 工作 中 心 、 配置 工作 中 心 、“ Availability and Performance” 可 
用 及 性 能 工作 中 心 、“Troubleshooting” 问 题 处 理工 作 中心 和 “SOA” 面 向 服务 工作 中 心 等 。 
单 击 “Site Map” 链 接 ， 可 以 看 到 所 有 工作 中 心 的 具体 功能 服务 清单 ， 如 图 8-1 所 示 。 


“Configuration” 


我 的 工作 空间 

收藏 夫 

最 近 使 用 
配置 向 导 (Inwa/cfg-wizard) 
应 用 程序 模块 Unwalapp-modules) 
BPM 系统 概览 
系统 概览 
流程 资源 库 (Inwa/bpm-repository) 
日 志 查 看 器 Unwanogs) 
目标 模板 管理 (Inwaldestinationtemplates) 
Java 调度 器 Unwascheduler) 
管理 任务 (Inwa/bpm-tasks) 
管理 流程 (Inwa/bpm-processes) 
启动 和 停止 Unwalstart-stop) 
应 用 程序 资源 Unwalapp-resources) 
Java 系统 属性 Unwa/sys-config) 


可 用 性 和 性 能 
系统 概览 
系统 概览 


监控 


资源 监 
rae 监控 Unwa/connection-mon) 
锁 (Inwallocks) 


Oi 式 事务 
系统 | 性 能 统计 
会 话 管理 (Inwa/sessionmgt) 
历史 记录 报表 
区 监控 
息 上 监控 器 
BPM E 
BPM 系统 概览 


操作 
系统 

应 用 程序 管理 器 

和 启动 和 停止 (Inwa/start-stop) 
用 户 和 访问 

系统 计量 


数据 和 数据 库 
ILM 存储 浏览 器 Unwaim-storebrw) 
Java 归档 主 控 室 (Inwa/archcockpit) 


配置 


安全 性 
验证 和 单 点 登录 (Inwa/auth) 
目标 (Inwaldestinations) 
身份 管理 (Inwa/identity) 
证 书 和 密 钥 Unwa/key-storage) 
受信 系统 (Inwaltrusted-systems) 
病毒 扫描 提 世 者 (Inwalvirus-scan) 
SSL (/nwa/ssl) 
ClickJacking Whitelist Configuration 
基础 架构 
Adobe 文档 服务 (Inwaladobe) 
应 用 程序 模块 Unwa/app-modules) 
应 用 程序 资源 Unwa/app-resources) 
Java 配置 浏览 器 (nwalcfg-browser) 
目标 (/nwa/destinations) 
Java HTTP 提 世 者 配置 (Inwa/http) 
国际 化 (Inwalinternationalization) 
Java 类 加 载 器 查看 器 Unwa/classloader) 


JCo RFC 提供 者 Unwajiico-destinations) 

JMS 服务 器 配置 (Inwalims) 

许可 证 (Inwallicenses) 

日 志 配 置 (Inwallog-config) 

消息 服务 器 (Inwa/msg-server) 
服务 注册 志 管 理 Unwa/SRConfig) 

系统 架构 目录 数据 提供 者 配置 (nwalsld-config) 
系统 信息 (Inwa/sysinfo) 

Java 系统 属性 (Inwa/sys-config) 

受信 系统 (inwartrusted-systems) 


计量 单位 管理 
企业 内 容 管理 


配置 向 导 (Inwa/cfg-wizard) 

流程 资源 库 (Inwa/bpm-repository) 
连接 性 

目标 (/nwa/destinations) 

Java HTTP 捍 世 者 配置 Unwa/http) 

JCo RFC 提 亿 者 (/nwa/jco-destinations) 


故障 排除 


Java 


Java 类 加 载 器 查看 器 (Inwa/classloader) 


JNDI 浏览 器 Unwaiindi) 
锁 (inwallocks) 
消息 服务 器 (inwalmsg-server) 
系统 信息 (nwa/sysinfo) 
比较 系统 


分 布 式 事务 

系统 性 能 统计 

数据 库 

JPA 监控 器 (/nwaljpa-mon) 


THF SQL 监控 器 (Inwa/sql) 

日 志和 跟踪 

日 志 配置 (Inwallog-config) 
日 志 查 看 器 Unwaogs) 

安全 故障 排除 向 导 

进程 和 任务 

业务 日 志 (Inwalbpm-bizlog) 
HUES BE (Inwalbrm-bizlog) 


流程 故障 排除 (Inwa/bpm-troubleshooting) 


BPM 操作 (/nwa/bpm-actions) 
高 级 故障 排除 

线程 转 傅 分 析 

HET 
SOA 
技术 配置 


目标 模板 管理 (Inwa/destinationtemplates) 
SOA 中 间 件 全 局 设置 Unwa/middleware-settings) 


目标 Unwa/destinations) 
服务 注册 表 管 理 Unwa/SRConfig) 
JCo RFC 提 世 者 (/nwaljco-destinations) 
系统 连接 (Inwalsystems) 

应 用 程序 和 场景 通信 
单个 服务 管理 Unwa/ssadmin) 
发 布 规则 Unwajpublicationrules) 


应 用 程序 通信 (/nwa/appcommunication) 


用 户 账 户 管 理 (Inwaluseraccmngt) 
业务 场景 通信 (Inwa/businesscfg) 


打开 SOL 数据 浏览 器 (Inwaldatabrowser) 


图 8-1 NWA 站 点 地 图 


o 可 用 性 和 性 能 工作 中 心 : 提供 给 管理 员 监 控 服 务 器 不 同 的 参数 和 不 同 服务 的 运行 状 
况 ， 如 Java 应 用 服务 器 状态 、BPM 系统 状态 、 连 接 器 状态 以 及 锁 等 信息 。 

。 运行 工作 中 心 : 提供 管理 员 对 服务 器 进行 操作 ， 如 启动 或 停止 不 同 的 应 用 程序 ， 用 户 
权限 管理 ，Java 调度 器 的 配置 和 使 用 ，jJava 服务 器 实例 与 应 用 的 管理 ，BPM 流程 和 任 
务 的 管理 等 。 

e 配置 工作 中 心 : 用 于 进行 所 有 与 服务 器 相关 的 配置 工作 ， 如 Adobe 技术 交互 表单 服 
务 、 应 用 程序 模块 、 应 用 程序 资源 、 系 统 单 点 登录 、 基 础 配置 向 导 等 。 

e 问题 处 理工 作 中 心 : 提供 了 系统 监控 相关 内 容 ， 如 BPM 运行 日 志 、 系 统 比较 、 核 心 
服务 应 用 情况 、 here: 

e 面向 服务 工作 中 心 : 包含 了 应 用 通信 、 
理 等 。 


业务 场景 通信 、 连接 性 日 志 记 录 、 目标 管 


8.2 服务 器 实例 与 应 用 


启动 和 停止 “Start&Stop”， 用 于 管理 服务 需 实 例 (instances) 的 运行 状态 ， 
查看 某 个 指定 实例 的 详细 信息 ， 所 有 的 相关 Java 服务 以 及 应 用 程序 也 会 
如 图 8-2 所 示 。 


同时 也 可 以 
详细 地 列 在 页 面 中 ， 
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w: 
= a Displays the status of the system instances. When you select a specifi y s the Java 
Q99 processes enabling start, stop, and debug options. All available Java services and applications are listed and can be 

i ed. 


Al 8-2 启动 和 停 
单 击 链 接 ’ 进 人 该 管 理 员 功 能 2 可 以 看 到 | Java Services | Java Applications 
: Java Instances” i Java Services 5 和 > Java Appli- | Start |[ Stop || Restart | | [Clear DNS Cache || Set Node Count | | [ More Actions 4 
cations” 3 个 标签 ， 分 别 列 举 了 当前 服务 器 中 所 z reer Hest 


有 活动 的 服务 器 结 点 实例 以 及 运行 在 对 应 实例 上 
的 所 有 Java 服务 和 Java 应 用 ， 如 图 8-3 所 示 。 


8.2.1 Java 服务 器 实例 


Java 应 用 服务 器 支持 服务 器 集群 ， 每 个 服务 器 可 以 安装 多 个 实例 ， 不同 的 实例 也 可 以 安 
法 在 不 同 的 物理 服务 带 上 ， 用 于 均衡 负载 。 在 Java 实例 页 签 中 可 以 看 到 当前 服务 器 所 安装 
的 所 有 实例 ， 它 们 是 应 用 集群 的 组 成 单元 ， 能 够 单独 地 启动 或 停止 ， 可 以 通过 系统 标识 实例 
编号 来 进行 区 分 ， 如 需 直 接 访问 不 同 实例 ， 除 了 实际 IP 有 区 别 外 ， 端 口号 也 会 根据 安装 时 
的 实例 编号 有 所 不 同 。 当 然 ， 也 有 很 多 时 候 ， 是 在 用 户 压力 测试 或 上 线 使 用 后 发 现 负 载 超过 
了 现 有 服务 央 的 人 硬件 能 力 ， 随 后 对 服务 器 进行 横向 地 扩充 以 缓解 服务 需 的 运行 压力 。 

当然 其 实在 每 个 SAP NetWeaver 服务 器 实例 中 又 包含 一 个 或 多 个 服务 器 绪 点 ( Server 
Node) ， 结 点 上 的 线程 担负 着 所 有 Java 应 用 的 运行 功能 ， 实 际 的 应 用 功能 、 功 能 请 求 处 理 都 
是 在 每 一 个 结 点 线程 上 完成 的 ， 因 此 服务 器 线程 是 服务 端的 最 小 应 用 处 理 单元 。 

服务 器 集群 的 负载 均 衔 一 般 由 Web 分 发 如 (Web Dispatcher) 完成 ， 它 负责 将 用 户 的 所 
有 请 求 在 不 同 的 服务 器 实例 之 间 进 行 转 发 和 均衡 ; 在 每 个 实例 的 内 部 ，Java 分 发 器 (Java 
Diapatcher) 则 承担 起 了 将 请 求 在 不 同 服务 器 结 点 继续 进行 转发 和 均衡 的 职责 ， 如 图 8-4 


所 示 。 


| 
负载 均衡 


= 


| Java ESSAN | Java 应 用 服务 器 实例 2 | | Java 应 用 服务 器 实例 3 | Java 应 用 服务 器 实例 4 


| Java-Dispatcher | Java-Dispatcher | Java-Dispatcher j | Java-Dispatcher j 
T L] U 1 
Java 应 用 程序 Í Java 应 用 程序 Í Java 应 用 程序 Java 应 用 程序 | 


bow 
E a 


图 8-4 多 实例 情况 的 服务 器 架构 


8-3 Java 实例 管理 界面 
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对 于 多 个 实例 的 Java 集群 (Cluster), SAP Web 分 发 如 (Dispatcher) 能 够 根据 不 同 实 
例 的 实际 使 用 情况 ， 有 效 地 分 发 请 求 到 不 同 的 Java Dispatcher 下 ,使 运行 中 的 多 个 实例 达到 
请 求 处 理 最 大 化 。Web 分 发 器 可 以 拒绝 或 接收 来 自 客户 端的 请 求 ， 一 旦 接收 就 会 平衡 各 个 
实例 负载 ， 因 此 Web 分 发 需 会 在 多 个 服务 器 实例 的 集群 架构 中 使 用 ， 没 有 必要 在 单 实例 中 
运行 Web 分 发 器 。 

再 往 上 一 层 ， 服 务 器 集群 (Cluster) 是 用 于 处 理 较 大 请 求 的 服务 器 配置 机 制 ， 当 用 户 数 
据 增 多 或 者 用 户 访问 请 求 增 大 ， 应 用 系统 不 能 满足 负载 时 ， 可 以 通过 对 集群 配置 的 扩容 来 加 
大 应 用 系统 对 物理 内 存 及 CPU 的 可 利用 空间 。 服 务 咒 实例 下 的 每 一 个 结 点 对 应 JVM 实例 在 
运行 ,通过 修改 JVM 的 堆 内 存 容量 可 以 扩大 JVM 对 物理 内 存 的 占用 ， 从 而 进一步 地 增加 可 
用 的 活动 JVM 进程 ， 而 集群 又 可 以 通过 配置 增加 服务 器 实例 来 扩展 集群 中 应 用 服务 实例 的 
数量 ， 将 硬件 使 用 率 最 大 化 。 在 实际 项 目 中 往往 因为 实际 的 在 线 用 户 数 大 于 预先 设计 的 用 户 
数量 而 导致 服务 器 超 荷 ， 从 而 引发 服务 器 罕 机 、 系 统 骨 泪 等 难 预料 的 生产 事故 ， 在 保证 了 硬 
件 服务 器 的 资源 下 ， 需 要 根据 用 户 实际 访问 负荷 对 服务 做 出 最 合理 的 配置 ， 以 达到 最 优 的 请 
求 处 理性 能 。 

ee Mae 
以 通过 单 击 “Start”“Stop” 或 “Restart” 分 别 
进行 实例 的 启动 、 停 止 或 重启 ， 如 图 8-5 所 示 。 ed E 


8.2.2 Java 服务 和 应 用 程序 


第 二 个 页 签 是 Java 服务 ， 可 以 看 到 当前 服务 器 中 所 有 的 Java 服务 、 服 务 组 件 名 称 以 及 
当前 运行 状态 。 与 Java 实例 页 签 中 的 功能 类 似 ， 在 Java 服务 页 签 中 也 可 以 通过 按钮 进行 启 
动 、 停 止 以 及 重启 等 动作 ， 如 图 8-6 所 示 。 


Java Services Java Applications 


Java Instances Java Services | Java Applications 
Services 
[ Start || Stop |[ Restart] | [More Actions 4 
T| Name = | Service Component Name Status 


| | ABAP Communicator 


| | Accounting Infrastructure Service 


engine.sap.com/r3startup O Started 
sap.comitc~bl~accounting_infra~srv O Started 
conVadminadapter O Started 
comV/appclient O Started 


| Administration Adapter 


| Application Client pects Infrastructure Service -~ Green LED; 


comtc~je~appcon figuration~api O Started 
com/applocking O Started 


wm wm 6 ow 
外 o oo 
lol 


| | Application Configuration API 
| | Application Locking 


到 8-6 Java 服务 的 操作 界面 


第 三 个 页 签 是 Java 应 用 程序 ， 可 以 看 到 当前 服务 器 中 所 有 的 Java 应 用 程序 ， 其 中 
“Vendor” X “sap. com”, EP SAP 提供 的 标准 应 用 程序 ， 而 通过 上 方 的 筛选 输入 框 也 可 以 模 
糊 查 找 用 户 自 定义 的 应 用 。 需 要 注意 的 是 ， 只 有 状态 为 “Started” (默认 使 用 绿灯 图 标 标 
记 ) 的 应 用 才能 够 正常 使 用 ， 所 以 当 自 定义 开发 的 Web Dynpro 应 用 程序 、BPM 流程 或 EJB 
应 用 无 法 使 用 时 ， 可 以 通过 这 里 的 状态 监控 查看 是 否 正 常 运行 ， 也 可 以 通过 按钮 对 应 用 进行 
重启 ， 如 图 8-7 所 示 。 

在 选中 任 一 应 用 程序 后 ， 在 下 面 还 有 与 应 用 相关 的 一 些 明细 信息 可 以 进行 配置 ， 如 依赖 
管理 、 模 块 、 明 细 等 内 容 ， 如 图 8-8 所 示 。 
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Java Instances Java Services Java Applications 


Application List 
Retrieve Status: [On ~| | | Start |[ Stop || Restart] | [More Actions 4 


M Name = | Vendor Status 
NP 
_activity_reporting_wd_hook sap.com O Started 
_Smart_usage_hook sap.com > Stopped 
| adc.editor sap.com © Stopped 
applicationsAdminApp sap.com © Stopped 


Al8-7 Java 应 用 程序 的 操作 界面 


Details About _activity_reporting_wd_hook 
it Modules | Resources Details Aliases 


More Actions « 


Th | Module Name 
FF 


m webdynpro/resources/sap.com/_activity_reporting_wd_hook 


图 8-8 模块 的 明细 信息 


8.3 作业 与 定时 任务 


作业 和 定时 任务 是 SAP NetWeaver 平台 的 一 个 核心 服务 ， 运 行 在 Java 应 用 服务 右上 ,在 
ERP 系统 (确切 地 说 ， 是 ABAP 架构 系统 ) 中 与 之 相对 应 的 则 是 CCMS 调度 程序 ， 可 以 通 
过 “SM36” 或 “SM37” 事 务 代 码 进行 访问 和 使 用 。 除 了 运行 标准 配置 的 定时 任务 以 外 ， 
Java 应 用 服务 器 的 定时 作业 服务 还 提供 了 第 三 方 的 Java 定时 作业 与 SAP Java 应 用 服务 器 集 
成 的 功能 。 

SAP NetWeaver 平台 为 Java 调度 程序 提供 了 低 等 级 任务 的 调度 配置 功能 ， 可 以 用 于 配置 
不 同类 型 的 定时 任务 ， 即 在 特定 时 间或 以 一 定 的 周期 在 Netweaver 服务 器 端 后 台 自动 地 运行 
某 些 Java 应 用 程序 。 从 Java 逻辑 角度 来 理解 ， 作 业 相 当 于 一 个 Java 类 ， 而 定时 任务 则 是 将 
作业 实例 化 之 后 再 添加 运行 规则 产生 的 “实例 ”。 

除了 服务 器 端的 支持 ， 在 开发 工具 NWDS 中 也 添加 了 对 定时 作业 下 的 支持 ， 在 创建 对 
应 的 开发 对 象 后 ， 可 以 直接 通过 菜单 自动 在 EJB 工程 中 生成 可 部 署 的 作业 定义 ， 省 去 了 手 
动 的 配置 环节 。 在 将 作业 部 署 到 服务 端 后 ， 还 可 以 通过 NWA 管理 者 平台 配置 定时 作业 的 启 
动 条 件 ， 另 外 NetWeaver 也 提供 了 定时 作业 相关 的 API， 可 以 在 应 用 程序 中 直接 编写 动态 启 
动 条 件 的 定时 作业 。 


8.3.1 创建 作业 项 日 


下 面 介绍 如 何在 NWDS 中 创建 一 个 调度 器 作业 项 目 。 

1) 首先 创建 一 个 新 的 调度 器 作业 开发 对 象 ， 进 入 NWDS 开发 者 工作 室 。 单 击 “File” 
一 “New” 一 “Other”， 在 弹出 的 对 话 框 中 找到 “Scheduler Job” 选 中 ， 并 单 击 “OK” 按 
钮 ， 如 图 8-9 所 示 。 

2) 选择 需要 生成 作业 的 EJB 工程 ， 填 写 包 名 、 类 名 ， 任 务 名 称 和 描述 ， 随 后 单 击 
“Finish” 按 钮 完成 任务 创建 ， 如 图 8-10 所 示 。 

3) 打开 Java 编辑 器 ， 在 自动 生成 的 “StardardJob” 类 中 编写 作业 运行 时 的 逻辑 ， 如 
图 8-11 所 示 。 
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EEC Haix 


New Scheduler Job 


P< 
Create a new SAP NetWeaver scheduler job in an existing EJB project 


Project: LocalDevelopment “mye jb01 “demo. sap. com 了 | 
© Visual Composer = ~ - 
Bia Source Folder: [\LocalDevelopment myejb01 demo. sap. com\ejbModule Browse... 
e 
© Web Dynpro 


E Web Servi Iava Package: com. myproject. jobs| Browse. .. | 
= Web Services 

& mL Class Name: StandardJob 

Superclass: [= sap. scheduler. runtime. mdb. MDBJobImplementation 


Job Name: StandardJob 


由 
日 


Job Description: |StandardJob 


© Eclipse Modeling Framework (2) < Back Hext | Cancel | 


EE EMF Model Query Plug-ins 


8-9 选择 文件 类 型 图 8-10 输入 调度 器 作业 信息 


器 


[we 
* Message-Driven Bean implementation class for: StandardJob 
* 

*/ 

(@MessageDriven(activationConfig = { 
@ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue"), 
@ActivationConfigProperty(propertyName = "messageSelector", propertyValue = "JobDefinition=\'StandardJob\' " + 

"AND ApplicationName=\'demo.sap.com/myear01\'") }) 

public class StandardJob extends MDBJobImplementation { 

[private static Final com-sap.tc.logging.Location logger = com.sap.tc.logging-Location 
.getLocation(StandardJob.class) ; 


/** 
* Default constructor. 
*/ 
public StandardJob() { 

// TODO Auto-generated constructor stub 
} 


Override 
ublic void onJob(JobContext jobContext) throws Exception { 
logger.infoT("Stardard Job Execution!"); 


8-11 添加 代码 


4) 接着 修改 对 应 的 xml 配置 文件 ， 在 “ejb - j2ee - engine. xml” 新 增 了 对 “Standard 
Job” 类 的 描述 属性 。 


<? xml version ="1. 0" encoding =" UTF - 8"? > 

< ejb — j2ee — engine xmlns :xsi = " http://www. w3. org/2001/XMLSchema — instance" 
xsi ; noNamespaceSchemaLocation = " ejb — j2ee — engine_3_0. xsd" > 
< enterprise — beans > 

< enterprise — bean > 

< ejb — name > StandardJob < /ejb — name > 

< bean - props > 

< property > 

< property — name > destination — name < /property — name > 

< property — value > JobQueue < /property — value > 

< / property > 

< property > 

< property — name > connection — factory — name < / property — name > 
< property — value > JobQueueFactory < /property — value > 

< / property > 

</bean — props > 

</enterprise — bean > 

</enterprise — beans > 

</ejb — j2ee — engine > 
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5) 接着 创建 一 个 “job - definition. xml” ACH OCF, Ff AL ear 描述 文件 中 添加 了 以 下 
描述 。 


< application — j2ee -enginexmlns xsi = "http://www. w3. org/2001/XMLSchema — instance" 

xsi; noNamespaceSchemaLocation = " application — j2ee — engine. xsd" > 

< referencereference — type = "hard" > 

< reference — targetprovider — name = " sap. com" target — type = "service" > scheduler ~ runtime </ 
reference — target > 

</reference > 

</application — j2ee — engine > 


6) 完成 配置 代码 后 ， 编 译 并 部 署 EAR 工程 至 Java 应 用 服务 器 ， 右 击 项 目 并 选择 “De- 
velopment Component” 一 “Build” 一 “Deploy”， 进 行 编译 和 部 署 ， 如 图 8-12 所 示 。 


Assign Working Sets... Show In Le 
Validate 

Het g Build 
nage 
Debug As 上 Update Project Settings 
Profile As 上 
Team 上 
Compare With 上 
Restore from Local History... = j F 

Configure Label Decoration... 

Java EE Tools 


Development Component 


K 8-12 部署 项 目的 菜单 选择 


7) 接着 使 用 管理 员 登 录 NWA 平台 ,选择 “操作 ”一 “作业 ”一 “Java HAE aE”, W 
Al 8-13 所 示 。 
8) 进入 页 面 后 ， 就 能 看 到 已 经 成 功 发 布 的 对 应 的 定时 作业 了 ， 如 图 8-14 所 示 。 


Jos Tass | Job Definitions External Schedulers 
我 的 工作 空间 | amtoe ORE, RE Job Definitions 
系统 | 用户 和 访问 ， 数据 和 数据 库 | 作业 进程 和 任务 Refresh 
aa | F Name 

加 Q Java ES iews 4 Ain 

ig BEES Jove RSS TRRRENIR Rial 
9 |) StandardJob 
图 8-13 NWA 平台 的 Java 调度 器 图 8-14 任务 定义 界面 


8.3.2 NWA 配置 定时 任务 


当 在 NWA 中 对 定时 任务 进行 启动 和 运行 方式 配置 时 ， 默 认 有 3 种 时 间 规 则 : 重复 (re- 
curing) 、 周 期 (Cron) 和 简单 (Simple) 。 

。 重复 : 在 配置 的 某 一 时 间 段 ， 按 照 配 置 的 发 起 间隔 执行 定时 任务 。 例 如 ， 将 开始 日 期 
(Start Date) 设置 为 “2016 -11 -11”、 结 束 日 期 (End Date) 设置 为 “2017 -11 - 
11”、 时 期 (Period) 1H “3s”, 那么 在 “2016 -11 -11” 到 “2017 -11 -11” 的 
这 个 时 间 段 内 每 3 秒 执行 一 次 定时 任务 。 

e 周期 : 用 于 指定 间隔 的 某 一 具体 时 间 点 执行 定时 任务 。 例 如 , 年 (Year) 设置 为 
“*”， 表 示 每 年 运行 ， 月 (Month) 设置 为 “8”, H (Day Of Month) 设置 为 “8”， 
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时 (Hour) 设置 为 “8”, 分 (Minute) 设置 为 “8”， 那 么 在 每 年 的 8 月 8 日 8 时 8 
分 执行 一 次 对 应 的 定时 任务 。 
e 简单 : 设置 一 个 未 来 时 间 点 ， 并 在 这 个 时 间 执 行 ， 配 置 任务 只 会 执行 一 次 。 例 如 ， 开 始 
日 期 (StartDate) 设置 为 “20161112”， 开 始 时 间 (Start Time) 设置 为 “18:08:09”， 
则 服务 器 会 在 这 个 时 间 点 执行 定时 任务 。 
下 面 在 服务 器 端 对 发 布 的 定时 任务 进行 具体 触发 条 件 的 配置 过 程 。 
1) 使 用 管理 员 登 录 NWA 平台 ,选择 “操作 ”一 “作业 ”一 “Java 调度 器 ”， 如 
图 8-15 所 示 。 
2) 选中 “Tasks” 任 务 页 签 ， 选 中 需要 进行 配置 的 作业 ， 随 后 单 击 上 方 的 “添加 ” 按 
钮 ， 如 图 8-16 所 示 。 


Select Job 
‘Oo F Name 2 | Description 

EMIS | 可 用 性 和 性能 OHI) mE ro ecco acinus 
系统 | 用 户 和 访问 | 数据 和 数据 库 | 作业 | 进程 和 任务 
国 Q Java 调度 器 Views 4 
Op BERG Java WASHER 

Java 调度 器 

图 8-15 NWA 平台 的 Java 调度 器 8-16 选择 任务 


3) 设置 定时 任务 的 基本 属性 ， 如 图 8-17 所 示 。 
4) 设置 其 他 参数 和 运行 规则 ， 这 里 以 简单 规则 为 例 进行 设置 ， 如 图 8-18 所 示 。 


Set Execution Time 
Recurring Cron Simple | 
Simple Time Table 
Jobs Tasks Job Definitions | External Schedulers | Date Time 
[| 2013-12-17 16:27:46 
Add Task 
I> 4 
Select Job Set Details 
Set Task Properties 
Task Name: StandardJob De 
Description: StandardJob Start Date: [2013-12-17 Œ] 
Start Time: [16:25:11 
Time Zone: | Asia/Shanghai CST x| 
Retention Period: [23 ] Add | [Remove] 
OJ BE E We JL Bet = ai 
图 8-17 设置 任务 属性 Z| 8-18 ”设置 执行 时 间 


5) 按照 规定 的 时 间 规 则 ， 查 看 生成 的 Jobs， 如 图 8-19 所 示 。 


Jobs 


lobal filter applied: 
None 


Refresh? Cancel || Remove || Next || Global Fiter 
‘Oo Name Status Return Code | Start 
F 
| || StandardJob COMPLETED 0 2013.12.17 16:27:46 CST 


图 8-19 查看 执行 状态 
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6) 同时 在 日 志 查 看 器 中 也 生成 了 对 应 的 运行 日 志 ， 表 示 该 任务 运行 成 功 ， 如 图 8-20 


所 示 。 


8.3.3 


[i] info 2013-12-17  16:27:46:022 Stardard Job Execution! 


图 8-20 运行 日 志 


WD4J 创建 定时 任务 


除了 上 面 的 通过 NWA 后 台 配 置 方式 设置 定时 任务 的 运行 规则 外 ，SAP 还 提供 了 调度 需 


的 API， 人 允许 开发 人 员 通 过 代码 端 直 接 访问 API 并 定义 时 间 规 则 启动 相应 的 定时 任务 。 
开发 实例 : 
1) 首先 打开 一 个 Web Dynpro 项 目 ， 并 在 视图 中 创建 一 个 触发 按 [ | 
钮 ， 如 图 8-21 所 示 。 图 8-21 ”运行 效果 


2) 定义 按钮 的 默认 动作 ， 并 在 Java 编辑 器 中 添加 动作 的 处 理 逻 辑 . 


// 通 过 JNDI 获取 scheduler 引用 
Scheduler scheduler; 
try | 
InitialContext ctx = new InitialContext( ) ; 
scheduler = (Scheduler) ctx. lookup( " scheduler" ) ; 
| catch (NamingException e) | 
wdComponentAPI. getMessageManager( ) 
. reportException(e. getMessage() ) ; 
return ; 
| 
// 获 取 JobDefinition 
JobDefinition helloJobDef = scheduler 
. getJobDefinitionByName( " StandardJob" ) ; 
// 创 建 时 间 规则 ,Recurring Time ,开始 时 间 与 结束 时 间 相 同 
Calendar calendar = Calendar. getInstance( ) ; 
// 时 间 点 为 一 分 钟 
calendar. add( Calendar. MINUTE ,1 ) ; 
java. util. Date date = calendar. getTime( ) ; 
// 通 过 calendar 创建 schedulertime 
SchedulerTime time = new SchedulerTime( date , TimeZone. getDefault( ) ) ; 
// 定 义 时 间 规 则 
RecurringEntry[ | re = {new RecurringEntry(time) | ; 
// ti) Task ,输入 参数 包含 了 Job 定义 Job 参数 .通过 代码 构造 的 时 间 规 则 ,以 及 Task 描述 
SchedulerTask task = SchedulerTask. createSchedulerTask(helloJobDef 
. getJobDefinitionId( ) ,null ,re,null ‚null , -2 ， 
"StandardJob Task" ,"StandardJob Task Description" , null ) ; 
// 执 行 Task 
try | 
scheduler. schedule( task) ; 
| catch ( TaskValidationException e) | 
wdComponentAPI. getMessageManager( ) 
. reportException(e. getMessage() ) ; 
return ; 
| 
wdComponentAPI. getMessageManager( ). reportSuccess(" 定时 作业 启动 成 功 !" ) ; 
// 注 :该 DC 需要 添加 对 tc/je/scheduler/api 的 依赖 。 
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3) 编译 、 部 署 、 运 行 ， 单 击 按钮 ， 如 图 8-22 所 示 。 ET 

4) 使 用 管理 员 登 录 NWA， 单 击 “操作 ”一 “作业 ”一 “Java 调 wa 
度 器 "， 就 可 以 查看 通过 代码 产生 的 定时 任务 及 其 触发 规则 ， 如 图 8-23 图 8-22 HER 
所 示 。 


5) HEA Java 调度 器 也 可 以 看 到 具体 任务 的 执行 情况 ， 如 图 8-24 所 示 。 
Jobs 
Tasks Global filter applied: 
Refresh || Add || Remove || Hold || Release one 
To | F Name = | Description Refresh ance! || Remove || Next || Global Filter 
SE Stand | FName Status Return Code 
StandardJob Task StandardJob Task Description SP Stand 
| StandardJob COMPLETED o 
图 8-23 MERHEIM 图 8-24 查看 任务 执行 状态 


注 : 一 般 调度 器 的 API 在 定时 任务 参数 或 触发 条 件 不 确定 ， 即 需要 动态 设置 的 情况 下 
使 用 ， 同 时 API 也 可 以 构造 复杂 的 时 间 规 则 ， 但 不 管 以 何 种 方式 配置 ， 都 要 及 时 进行 管 
理 和 监控 。 


8.4 Adobe 技术 交互 表单 


Adobe 技术 的 SAP 交互 表单 是 SAP 和 Adobe 公司 为 了 提供 更 好 的 表单 创新 以 及 可 操控 
性 联合 提出 的 一 个 表单 解决 方案 。 这 一 解决 方案 与 SAP 的 设计 时 以 及 运行 时 环境 高 度 集成 ， 
可 以 保证 Adobe 标准 的 表单 在 SAP 相关 应 用 程序 中 的 正常 浏览 、 使 用 甚至 是 业务 数据 交互 。 
它 可 以 在 SAP 系统 的 下 列 场景 中 被 定义 和 使 用 : 
1) 在 表单 编辑 器 中 或 是 ABAP 工作 台 提 供 表单 制作 ，Adobe 技术 的 表单 可 以 被 用 以 打 
印 、 归 档 或 是 作为 电子 邮件 直接 进行 发 送 。 
2) Æ Web Dynpro 的 开发 环境 中 (包括 Web Dynpro ABAP 和 Web Dynpro Java) 作为 在 
线 的 交互 式 表 单 进行 开发 和 制作 ， 可 用 于 Web Dynpro 应 用 程序 的 页 面 打 印 或 数据 交互 。 
3) 通过 在 NetWeaver 平台 预先 安装 | assava AS Java 
ADS 服务 的 环境 中 ， 通 过 LCD 编辑 带 进 
行文 档 模板 的 统一 制作 。 
从 WD4J 的 开发 技术 角度 来 说 ，ADS O 
( Adobe Document Services) 是 运行 在 | | 2 Appleton 
NetWeaver Java Di AIRS ## ZE AY Adobe 23 
ii ae ere 
ADS 在 运行 环境 生成 通过 LiveCycle De- ee Te 
signer 编辑 器 制作 的 页 面 模板 表单 设计 
时 可 以 绑 定 Web Dynpro 应 用 程序 中 的 上 有 
下 文 ， 以 实现 实时 数据 的 展现 与 交互 ， 
如 图 8-25 所 示 。 


8.4.1 ”配置 本 地 LCD 
对 于 访问 应 用 程序 以 及 操作 使 用 表单 的 最 终 用 户 来 说 ， 客 户 端 能 够 查看 Adobe 表单 需要 
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图 8-25 WD4J 与 ADS 交互 的 架构 图 


提前 安装 Abode Reader 软件 ， 因 此 使 用 WebDynpro 打印 Adobe 表单 时 ， 需 要 在 本 地 安装 对 
应 版 本 的 Adobe Reader 产品 。 

对 于 开发 人 员 而 言 ， 在 本 地 开发 客户 端 和 个 人 计算 机 中 ， 需 要 预先 安装 Adobe LiveCycle 
Designer (LCD), LCD 是 Adobe 公司 提供 的 PDF 编辑 器 ，SAP 的 开发 与 运行 环境 都 实现 了 
与 该 工具 的 集成 ， 客 户 端 安装 LCD 后 ， 开 发 人 员 可 以 直接 通过 NWDS 中 编辑 视图 元 素来 创 
建 和 修改 自 定 义 的 交互 表单 。 

LCD 同时 支持 NWDS 开发 与 ABAP 工作 台 。SAP GUI 客户 端 已 经 集成 了 对 LCD 的 集成 ， 
但 需要 注意 的 是 ，SAP GUI7. 30 以 上 的 版 本 才 支 持 Designer 9. 0。 随 着 NetWeaver 平台 的 不 
WIth, HRT LiveCycle Designer 9. 0 支持 NetWeaver 7.30 及 以 上 版 本 的 ADS, LiveCycle De- 
signer, Adobe Reader 以 及 NetWeaver 三 者 的 版 本 只 有 保持 一 致 ， 才 能 够 正确 地 使 用 。 表 8-1 
所 示 为 NetWeaver 的 不 同 版 本 以 及 能 够 支持 的 LiveCycle Designer 版 本 信息 。 


表 8-1 NetWeaver 不 同 版 本 的 支持 信息 


LiveCycle Designer NetWeaver Adobe Reader 
8.1 7.0 SP13 及 以 上 7.05 及 以 上 
8.2 7.20 及 以 上 8.1 及 以 上 
9.0 系列 7. 30 及 以 上 9.0 及 以 上 
9.8 7.30 及 以 上 9.1 及 以 上 
10.0 7.30 及 以 上 91 及 以 上 
8.6 9.1 及 以 上 


通过 SAP 的 官方 文 持 网 站 就 可 以 下 载 对 应 版 本 的 LiveCycle Designer (访问 地 址 参考 . 
http ://service. sap. com/ installations ) 

打开 链接 后 目录 参考 :“Installations and upgrades” — “Browse our Download Catalog” 一 
“SAP NetWeaver and complementary products”, {| 8-26 所 示 。 


objects are available for download: 
File Type Download Object Title Info File File Size [kb] 


ZIP 50120297 1 [nw 7.0 Presentation - Adobe LiveCycle Designer 9.0 | Info 459151 
PERTE PE eh 
图 8-26 ”下载 安装 文件 


在 WD4J 的 开发 过 程 中 ， 只 有 安装 Adobe LCD 表单 设计 器 的 插件 ， 才 能 通过 NWDS 直 
接 编辑 Adobe 交互 表单 。LCD 设计 顺 也 提供 了 多 种 不 同 表单 制作 控件 ， 这 WebDynpro 
视图 元 素 的 设计 思路 相同 ， 既 能 够 满足 复杂 多 样 的 表单 格式 设计 ， 又 可 以 直接 通过 设计 器 将 
表单 控件 与 Web Dynpro 上 下 文 进 行 绑 定 ， 从 而 实现 动态 实时 表单 的 功能 。 
在 正确 安装 后 ， 打 开 NWDS 中 任意 的 Web Dynpro 项 目 ， 即 可 
添加 交互 表单 对 应 的 视图 元 素 “Interactive Form”， 如 图 8-27 
所 示 。 
在 选择 编辑 该 元 素 后 ， 就 能 通过 LCD 设计 器 对 表单 进行 详细 
的 设计 和 开发 了 。 图 8-28 是 默认 的 设计 器 使 用 界面 ， 上 方 是 设计 
器 的 工具 栏 ， 左 侧 是 元 素 清单 的 结构 图 (类似 于 Web Dynpro 中 Outline 的 元 素 清单 ) PE 
是 设计 视图 ， 显 示 了 表单 的 实际 展现 效果 ; 右 侧 是 图 形 化 的 控件 使 用 以 及 相关 控件 属性 的 详 
细 配 置 视图 ， 如 图 8-28 所 示 。 
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图 8-27 视图 的 预览 效果 


Edit View Insert Table Layout Tools Palettes Help 


EET EE 


N -> | |" Design view [Master Pages preview PDF | SE ~ T<) 
一 
Choose a topic... 可 aoe 


2 = | 

FE) United Content area) | | Žž ~a 

= D) games ston oa : 
TextField1 H H eo i 

J, (Referenced Objects) ! i ©) Lal LL) <| 

2-49} (Variables) i | Radio Button _ Rectanale Text zi 


22 ContsinerFoundation_25 | [>] 
! i Object &\ Accessibility = 
Master Page 


Name: Pages 


Paper Type: Letter ba 
Height: [iin Width: [isin 


Orientation: ( Portrait {© Landscape 


图 8-28 iziii M 


8.4.2 配置 ADS 服务 


在 完成 了 开发 人 员 和 用 户 端的 本 地 配置 后 ， 需 要 对 SAP NetWeaver 中 的 ADS 服务 进行 配 
置 ， 以 便 正 确 提供 对 于 Adobe 表单 运行 时 的 支持 。 基 础 配置 包括 创建 验证 用 户 、 建 立 PDF 
对 象 层 到 ADS 的 权限 认证 。NWA 提供 了 在 线 自动 执行 的 配置 功能 ， 如 果 后 台 执行 失败 ， 则 
自 定义 参数 时 可 以 使 用 手工 配置 。 以 下 是 详细 的 配置 过 程 。 

配置 实例 : 

1) 检查 当前 服务 顺 环 境 是 否 安装 有 ADS 服务 ， 访 问 地 址 为 : http:// <host > : < port >/ 
sld/fun。 如 尚未 安装 对 应 服务 的 环境 ， 则 需 先 进行 安装 文件 的 下 载 和 安装 工作 ， 如 图 8-29 
所 示 。 


Functional Unit Dn = Usage Type 

Adobe Document Services (not installed) =e Adobe Document Services 

Advanced Adapter Engine (AF) (not installed) PI Adapter Engine 

Advanced Adapter Engine Extended (AEX) (not installed) Advanced Adapter Engine Extended or Process 
BI Java (not installed) BI Java 


CM Services (Change Management Services) (not installed) Application Server Java 


8-29 ”检查 已 安装 服务 


2) 创建 验证 用 户 。 使 用 管理 员 账 号 创建 一 个 验 ee 
证 用 户 ， 在 “登录 标识 ”文本 框 中 输入 “ADSUs- 
er”， 在 “安全 策略 ”下 拉 列 表 中 选择 “技术 用 户 ” i 
(这 是 针对 后 台 服 务 的 用 户 类 型 ,不 需要 修改 登录 ww 
密码 ， 避 免 连接 错误 ) ， 如 图 8-30 所 示 。 sam * AOS 


3) 分 配 ADS 所 需要 的 角色 给 该 用 户 ， 可 直接 搜 aTa: 
索 “SAP_ADSCALLER”， 不 需要 额外 创建 ， 如 图 8-31 = = 
所 示 。 og E 


Al 8-30 创建 新 用 户 
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已 分 配 的 角色 


waa: | MERE v] Ošs 25] 
主体 类 型 2h 2 
D SAP_ADSCALLER 


8-31 搜索 角色 


4) 创建 ADS 服务 目标 ， 使 用 管理 员 账 号 登录 http:// < host > : < port >/nwa 管理 者 平 
台 ， 选 择 “SOA” 工 作 中 心 ， 并 找到 “技术 配置 ” (Technical Configuration) 中 的 “目标 模 


PF FE” (Destination Template Management) ， 打 开 链 接 后 ， 单 击 “ 新 建 ” 按 钮 ， 新 建 日 标 ， 
如 图 8-32 所 示 。 


Enter a name for the logical port 


Destination Type: WSIL 


v 
J 


Destination Name: * ConfigPort_Document 


URL: * http://<host>:<port>/inspection. wsil 

Socket Timeout (in Milliseconds): 60,000 Bl 
System: ©) Java (©) ABAP 

System Name: _ 

Host Name: 


8-32 输入 目标 信 ， 


证 


5) 完成 基本 信息 填写 后 ， 单 击 “ 下 一 步 ”按钮 ， 进 行 认证 配置 ， 输 入 之 前 创建 的 用 户 
“ADSUser” 及 其 密码 ， 随 后 单 击 “ 完 成 ”按钮 ， 如 图 8-33 所 示 。 


Authentication 


Authentication: |HTTP Authentication w 
®© User ID/Password (Basic) 
D User ID/Password (Digest) 
O X.509 Client Certificate 
D Logon Ticket 


[Detaiis Off | 


Details 


User ID/Password 号 


User ID: ADSUser 
Password: | 


ConfirmPassword: = =«_ | weeese 


Al 8-33 ”输入 认证 信息 


6) 完成 创建 后 ， 就 可 以 在 目标 表格 中 看 到 对 应 的 项 目 并 使 用 了 ， 如 图 8-34 所 示 。 


New || Delete 


m| F Destination 
F bonfig 
= ConfigPort_Document 


图 8-34 ”目标 清单 


7) 除了 手动 填写 配置 外 ，NWA 还 提供 了 在 线 配置 工具 ， 可 以 使 上 述 过 程 在 后 台 自 动 


完成 ， 过 程 执行 完 后 系统 默认 创建 对 应 用 户 “ADSUser” 以 及 目标 “ConfigPort_Document , 
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如 图 8-35 所 示 。 


Functional Units 


Enable automatically || Enable manually | Resume || Disable |[ Refresh | 


T | Functional Unit 


图 8-35 ”自动 配置 的 操作 界面 


8.4.3 WD4J 开发 交互 表单 


在 完成 了 本 地 配置 以 及 服务 器 端 配置 后 ， 就 可 以 通过 NWDS 进行 表单 的 开发 以 及 使 用 


了 ， 有 具体 过 程 如 下 。 


性 。 


人 


1) Æ Web Dynpro 项 目 中 打开 任意 一 个 视图 ,首先 创建 表单 所 需要 的 上 下 文 结 点 和 特 
创建 一 个 集合 属性 为 “1 .. 1” 的 “PrintNode” 结 点 ， gone 一 个 “header” 结 点 和 一 


“contentList”， 集 合 属 性 分 别 为 “I.e.” Fl “0+ ， 用 于 存放 对 应 的 表 头 信 息 和 行 


项 目 信息 。 随后 创建 对 应 字段 的 相关 特 E 如 图 8-36 所 示 ， 


È- -E FrintHode 
局 = +o contentLis 
be B addres 


-B remark 


Hp comp 


图 8-36 ”上 下 文清 单 


2) 右 击 “Outline” 中 的 “RootElement” 根 结 点 元 素 ， 选 择 添 加 子 元 素 ， 在 弹出 的 对 话 


框 中 选择 “InteractiveForm” 类 型 元 素 ， 并 单 击 “OK” 按 钮 ， 如 网 8-37 所 示 。 


Category Library UI Element 


[A11] [A11] “=| InteractiveForm 
Action Adobe 

Complex Business Intelligence 

Graphic Mobile Add-Ons 

Integration Office Integration 

Layout Standard 


Menu 


Selection 
Text 
Toolbar 


图 8-37 选择 元 素 类 型 


3) 添加 完成 后 即 可 看 到 对 应 的 元 素 对 象 ， 如 图 8-38 所 示 。 
4) 选中 “InteractiveForm”， 将 属性 中 的 “dataSource” 数 据 源 指定 上 下 文中 的 “Print- 


Node” 绪 点 ,保存 所 有 修改 ， 如 图 8-39 所 示 。 


355 


contextMenuld 


= dataSource C PrintNode 
i displayType [Deprecated] activex* 
Context Menus enabled true 


Al8-38 ”元素 清单 图 8-39 修改 属性 


5) 右 击 “Outline” 中 的 “InteractiveForm”， 在 弹出 快捷 菜单 中 选择 “Edit”， 对 表单 进 
行 编辑 ， 如 图 8-40 所 示 。 


Replace With 
Wrap With 
% Delete 


Parameter Mapping 
Translatable Texts 


图 8-40 编辑 对 象 的 菜单 选择 


6) 进入 Adobe LCD 编辑 器 ， 如 图 8-41 所 示 。 


~* | 中 Design View |) Master Pages | Preview PDF 加 ax 
Hierarchy GB \POF Structure Qata View Ya [T] BB Be Bt Bt Gt Bi Obea irama ae 
= — — — 一 一 Image sä Image Field 
5- PrintNode | m m a | al 5 
a FD (Master Pages) | 4 : Z une 国 usteox 
SPU) Pager | SA Numeric Field {A Paper Forms Barcode 
F® (untited Content Area) | MA password Field Cprint Button = 
L) (untitled subform) (page 1) kJ radio Button 国 Recange E 
a), (Referenced Objects) d CReset Button Subform 
日 全 (Variables) 7 =| | E Tabe 国 rex 
{2) containerFoundation JS i YA Text Field 
2 4 | >» Custom = 
4 x 
Object `| Accessibility 5 = 
Ie i Role: (None) ~ 
| J 
| 4 
4 
| 
| 
is J 
Pq z i. 


8-41 LCD 编辑 器 界面 


7) 最 左 侧 的 窗口 中 默认 显示 “Hierarchy” 视 图 ， 用 于 展现 设计 视图 的 页 面 元 素 层 次 结 
构 ， 包 括 主页 面 、 页 面 、 子 表单 等 内 容 。 在 子 表单 (Subform) 中 编辑 页 面 需要 的 控件 ， 如 
Al 8-42 所 示 。 


Ej E PrintNode 
aD (Master Pages) 
S-P Paget 


|) (untitled subform) (page 1) 
%) (Referenced Objects) 
B-s} (Variables) 
A ContainerFoundation_JS 


RS 
Tos 


8-42 FAH HE PAN TOR A 


8) 最 左 侧 窗 口中 隐藏 的 “DataView” 用 于 查看 绑 定 的 数据 源 对 应 的 结 点 结构 ， 如 图 8-43 
所 示 。 
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9) 最 右 侧 的 窗口 默认 显示 “Object Library” 控 件 库 ， 包 含 了 所 有 可 编辑 的 表单 控件 ， 
根据 不 同类 型 放 在 不 同 的 子 标签 中 ， 类 似 于 Web Dynpro 视图 中 的 UI 元 素 库 ， 如 图 8-44 
所 示 。 


日 - 因 PrintNode 
@_selected 
@_leadSelected 
of header 
{A| @_selected 
[7| @_leadSelected 
TA @dept Object Library & z] 
DA @comp > MyFavorites i 
=)! contentList > Standard =. 
a @_selected > mee = 
a ©_eadSelected - een en 
a lee >» Web Dynpro Native ize 
>» Web Dynpro Activex = 
A Qaddiess b ISRControls 
LA @remark ee 


图 8-43 结 点 结构 图 8-44 UI 元 素 库 


10) 其 中 “Standard” 标 准 对 象 中 包含 了 一 些 常用 的 控件 ， 如 图 8-45 所 示 。 

11) 右 下 方 窗口 则 显示 了 视图 控件 的 详细 属性 ， 通 过 Object 修改 控件 各 种 属性 ， 使 页 
面 的 风格 统一 。 根 据 控件 类 型 的 不 同 ， 属 性 分 为 不 同 的 页 签 ， 其 中 “Binding” 用 于 标识 绑 
定 该 控件 对 应 的 数据 源 ， 即 Web Dynpro 上 下 文 对 象 ， 如 图 8-46 所 示 。 


Object mu Accessibility “ f= 
Subform `| Pagination { Binding 
v Standard = nane 
C Button W]check Box Default Binding (Open, Save, Submit): 
WD Cirde FS Content Area Normal = 
[EP Date/Time Field FA Decimal Field A 
Document Signature Field Import/Export Bindings (Execute): 
TE" Drop-down List C Email Submit Button EP 
HTTP Submit Button 
H image äl Image Field [E] Repeat Subform for Each Data Item 
A, Line =i List Box Min Count: Max: 
Numeric Field iil Paper Forms Barcode EA 
Initial Count: 
EA password Field BPrint Button 


图 8-45 ”常用 控件 图 8-46 控件 的 详细 属性 


12) 编辑 器 的 中 间 窗 口 则 用 于 视图 的 设计 和 开发 ， 隐 藏 的 “Preview PDF” 视图 用 于 设 
计 模 板 的 离线 预览 ， 可 以 随时 查看 开发 页 面 的 实际 显示 效果 ， 如 图 8-47 所 示 。 


D Design View | ] Master Pages œ|% Preview PDF œ 
2 Cte te Bet Pe B ri PY 


图 8-47 设计 视图 与 预览 视 医 


13) 下 面 开始 对 表单 页 面 内 容 的 编辑 开发 。 其 中 ， 表 头 显 示 公 司 与 部 门 ， 使 用 “Text- 
Field” 控 件 ， 内 容 则 以 表格 方式 显示 人 员 列 表 属 性 。 首 先 从 “Object Library” 中 选择 “Tex- 
tField” 并 拖 电 至 “Disign View” 设 计 视 图 中 ， 如 图 8-48 所 示 。 
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14) 选择 该 控件 对 其 属性 进行 调整 ， 


将 文本 修改 为 “公司 ”， 如 图 8-49 所 示 。 


| Q Design View | 
到 


_| Master Pages 


国 | A Preview PDF œ 
par ores eared eo A RY STE WE 


WAE rere 


= Text Field 


Ei oo 


8-48 添加 后 效果 


8-49 ”修改 文本 


属性 


15) 随后 在 右 下 方 找到 “Binding” 中 的 “Default Binding”， 单 击 右 侧 按 钮 并 找到 对 应 
的 上 下 文 特性 ， 对 控件 和 上 下 文 进行 绑 定 ， 如 图 8-50 所 示 。 


16) 
17) 


完成 了 对 应 控件 与 Web Dynpro 
| 


You can update all, some, or none of the object's 
Properties to match the properties of the data item 
in the data source. 


Binding Properties 


(© Update all related properties. 
5 Update the following properties only: 
Name 
Caption 
Default Value 


© Don't update any related properties. 


[E] Don't Show Again 


| œ 


| [cancel 


TA] 


属性 对 话 和 


绑 定 


图 8-51 


Default Binding (Open, Save, Submit): 
None Normal 
Data Format: Plain Text X Global 
PrintNode > @_selected | 
[Import/Export Bindings (Execute): None @_leadSelected 
Na header 上 @_selected 
contentList > @_leadSelected 
@dept 
@comp 
Pt > 、 
RI 8-50 绑 定 上 下 文 的 菜单 选择 


在 弹出 的 对 话 框 中 选择 是 否 更 新 相关 属性 ， 选 择 不 更 新 相关 属性 ， 如 图 8-51 所 示 。 


上 下 文 的 绑 定 ， 如 图 8-52 所 示 。 


Default Binding (Open, Save, Submit): 
header[*].comp 


Data Format: Plain Text 


Al8-52 完成 绑 定 后 的 界面 


18) 按照 相同 的 方法 添加 部 门 输入 框 控件 ， 并 绑 定 对 应 的 上 下 文 特 性 ， 如 图 8-53 


所 示 。 


19) 随后 设置 字体 格式 ， 选 择 标签 字体 即 可 进行 设置 。 将 “Hierarchy” 视 图 中 的 对 象 
批量 选中 ， 随 后 修改 字体 为 “Adobe Song Std. L”， 如 图 8-54 所 示 。 


Currently editing Caption and Value... è 
Font: ETETETT X 
Size: 10 v Baseline Shift: Opt 


ao [+d 


7 


Ste: By Iv U~ we Ar 


8-53 创建 后 的 效果 
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8-54 ”修改 字体 


20) 可 以 单 击 “Preview PDF” HEF PDF 文件 预览 ， 查 看 预览 效果 ， 如 图 8-55 所 示 。 


D Design View ‘| Master Pages & |) Preview PDF ®| 


8-55 预览 效果 


21) 修改 控件 显示 样式 ， 在 “Hierarchy” 视 图 中 批量 选中 新 建 的 控件 ， 在 Object 视图 
中 找到 “Field” 页 签 中 的 “Appearance” 属 性 ， 选 择 “None”， 如 图 8-56 所 示 。 
22) PA “Value” 页 签 ; TE “ Type” 下 拉 列 表 中 选择 “Read Only” , 如 图 8-57 所 示 。 


Field \Value “Binding N 


Type: YA Text Field 


Field ] Value N Binding \ 


Type: |Read Only X 


Caption: mixed Default: 


Appearance: [None | 
8-56 修改 属性 1 8-57 ”修改 属性 2 
23) 再 次 进行 PDF 预览 ， 确 认 实 际 效 果 与 预期 相符 ， 如 图 8-58 所 示 。 


D Design View Master Pages & 4) Preview PDF 国 | 


8-58 ”预览 效果 


24) 接着 在 设计 视图 中 插入 表格 ,设置 列 数 与 默认 行 , 单 击 “OK” 按 钮 ， 如 图 8-59 
所 示 。 
25) 在 设计 视图 中 的 效果 如 图 8-60 所 示 。 


Insert Table ESj 
©) Create Simple Table: OK 
3 4 2 
Columns: x Cancel 


BodyRows: 1 


[V] Indude Header Row in Table 


aa | an 


回 Indude Footer Row in Table 


© Create Table Using Assistant 


[E] Don't Show Again 


8-59 ”插入 表格 对 话 框 图 8-60 预览 效果 
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26) 编辑 表 头 ， 设 置 表 头 的 描述 以 及 对 应 字体 ， 如 图 8-61 所 示 。 


图 8-61 编辑 文本 属性 


27) 选中 表格 ， 在 右 下 属性 中 找到 “Binding” 一 “Default Binding”， 进 行 上 下 文 绑 定 ， 
如 图 8-62 所 示 。 


efault Binding (Open, Save, Submit): 


None Normal 
mport/Export Bindings (Execute): a Pe 


contentList 


None 


Al8-62 绑 定 上 下 文 的 菜单 选择 


28) 批量 选择 单元 格 对 象 ， 选 择 “Text” 类 型 ， 如 图 8-63 所 示 。 

29) 选中 每 一 个 单元 格 ， 并 分 别 绑 定 Web Dynpro 的 上 下 文 ， 如 图 8-64 所 示 。 

30) 接着 选中 表格 中 的 “Row” 行 ， 在 右 下 “Object” 对 象 属性 的 “Binding” 中 选中 
“Repeat Row for Each Data Item” 复 选 框 ， 用 于 显示 多 条 的 行 项 目 数 据 ， 如 图 8-65 所 示 。 


Object N Accessibility 


Cell | Value ` Binding 


ajs lame: Cell1 0 7 R ERF 
Object & \ Accessibility = Kees Row for Each Data Item 
Cell Pefault Binding (Open, Save, Submit): [V] Min Count: 1 回 Max: 
id = [V] Initial Count: 3 
Type: 国 Text bd 回 : | 
Data Format: Plain Text X 


器 


8-65 ”修改 属性 3 


到 8-63 ”修改 属性 1 到 8-64 ”修改 属性 2 


31) PDF 预览 查看 确认 表单 的 实际 效果 ， 如 图 8-66 所 示 。 


公司 部 门 


图 8-66 预览 效果 


32) 在 完成 表单 页 面 的 开发 后 ， 回 到 Web Dynpro 的 项 目 中 ， 进 入 视图 的 Java 编辑 央 ， 
在 初始 化 方法 中 添加 测试 用 例 的 代码 ， 即 可 编译 运行 : 


publicvoid wdDoInit( ) 


| 
//@ @ begin wdDolnit( ) 


// 赋 值 表 头 


IHeaderElement currentHeaderElement = wdContext. nodeHeader( ) 
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. currentHeaderElement( ) ; 
currentHeaderElement. setComp("SAPEYES 公司 " ) ; 
currentHeaderElement. setComp("SAPEYES 部 门 " ) ; 
/赋值 表 内 容 
IContentListNode nodeContentList = wdContext. nodeContentList( ) ; 
IContentListElement createAndAddContentListElement = 
nodeContentList. createAndAddContentListElement( ) ; 
createAndAddContentListElement. setId( "001" ) ; 
createAndAddContentListElement. setName('" Wang" ) ; 
createAndAddContentListElement. setAddress(" 地址 01" ) ; 
createAndAddContentListElement. setRemark(" 备注 01" ) ; 
createAndAddContentListElement = 
nodeContentList. createAndAddContentListElement( ) ; 
createAndAddContentListElement. setId( "002" ) ; 
createAndAddContentListElement. setName( " Zhang" ) ; 
createAndAddContentListElement. setAddress(" 地址 02" ) ; 
createAndAddContentListElement. setRemark(" 备注 02" ) ; 
createAndAddContentListElement = 
nodeContentList. createAndAddContentListElement( ) ; 
createAndAddContentListElement. setId( "003" ) ; 
createAndAddContentListElement. setName(" Li" ) ; 
createAndAddContentListElement. setAddress(" 地址 03" ) ; 
createAndAddContentListElement. setRemark(" 备注 03" ) ; 
//@ @ end 
| 


8.5 自 定 义 数据 源 


在 Web Dynpro 开发 中 ， 大 部 分 的 数据 源 都 通过 模型 导入 接口 的 方式 将 原始 数据 传递 给 
Web Dynpro 的 应 用 程序 。 但 是 在 很 多 企业 中 ， 保 留 了 很 多 原 有 的 系统 ， 可 能 对 于 开发 接口 
存在 人 员 或 技术 上 的 不 足 。 对 于 这 样 的 业务 场景 ，SAP 在 NetWeaver 平台 中 提供 了 配置 JD- 
BC 驱动 的 方式 进行 数据 库 的 直接 访问 ， 这 也 是 Web Dynpro 应 用 程序 中 直接 操作 数据 库 的 常 
用 方式 ， 数 据 源 的 配置 可 以 脱离 与 代码 开发 的 紧 耦 合 关系 : 一 方面 ， 数 据 的 连接 信息 不 需要 
通过 硬 编码 写 入 应 用 程序 ， 在 数据 库 迁 移 或 应 用 程序 迁移 涉及 连接 信息 修改 时 ， 不 需要 再 次 
修改 应 用 程序 的 开发 代码 ， 保 证 了 程序 代码 的 完整 可 靠 ， 另 一 方面 ， 数 据 库 的 连接 数 可 以 进 
行 实时 在 线 调 配 ， 根 据 实 际 系统 的 负荷 以 及 用 户 访问 量 随时 随地 通过 NWA 平台 进行 修改 。 
从 项 目 实施 客户 角度 来 看 ， 数 据 库 连 接 信息 也 可 以 保持 与 代码 的 独立 性 ， 不 再 需要 担心 客户 
数据 库 相 关 信 息 面向 开发 人 员 的 公开 和 小 范围 分 享 ， 从 某 种 程度 来 说 ， 提 升 了 数据 库 的 保密 
性 和 安全 性 ， 降 低 了 对 原 有 系统 的 影响 和 风险 。 

下 面 通过 一 些 开 发 和 配置 实例 进行 实践 ， 具 体 包括 创建 数据 库 连接 驱动 、 配 置 自 定 义 数 
据 源 以 及 访问 自 定义 数据 源 几 个 方面 。 


8.5.1 创建 连接 驱动 


1) 首先 使 用 管理 员 账 号 登录 SAP NetWeaver 系统 的 NWA 平台 ， 接 着 进入 “Configura- 
tion” — “Infrastructure” 一 “Application Resources”， 在 “Show” 下 拉 列 表 中 选择 “JDBC 
Drivers”， 如 图 8-67 所 示 。 
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Application Resources: Overview 


Favorites, Related Links, GoTo, Support Details 


K 
Show: | JDBC Drivers v 


| Resource List 


Create New Resource 4 || Delete Selected Resource Refresh || More Actions 4 


图 8-67 查看 JDBC 驱动 


2) 单 击 “Create New Resource” 按 钮 ， 在 弹出 的 菜单 中 选择 “DeployNew JDBC Driv- 
Le ere arene tings 竺 接 的 根本 ， 只 有 先 上 传 指 定 版 本 的 类 库 ， 才 能 创建 

对 应 的 数据 库 连 接 ， 如 图 8-68 所 示 。 

3) 接着 输入 自 定义 驱动 名 称 “Ora_Driver”， 用 于 连接 甲骨 文 数据 库 ， 单 击 “Add New 
Driver File” 按 钮 ， 如 图 8-69 所 示 。 


Create New Resource 4 || Delete Selected Resource 
mj | Deploy New JDBC Driver : _ 
New JDBC Driver Creation 


| New JDBC Custom DataSource 


| New JDBC DataSource Alias 
| New JMS Connection Factory Reference - Settings | 


— New JMS Destination Reference 
_| New JMS Saf Agent Reference 


lected Driver File 


| New Resource Adapter 


图 8-68 创建 资源 的 类 型 选择 图 8-69 ”添加 新 的 驱动 文件 


4) 在 弹出 的 对 话 框 中 选择 本 地 的 数据 库 驱 动 文件 ， 单 击 “OK” 按 钮 进行 上 传 ， 这 里 
以 甲骨 文 数 据 库 的 驱动 文件 为 例 ， 如 图 8-70 所 示 。 

ee bay 完成 配置 后 ， 在 清单 中 就 能 看 到 新 建 的 连接 驱动 了 ， 前 面 绿色 
的 图 标 表示 状态 正 J, WE 8-71 所 示 。 


File Upload 


[DAWibvojdbc6 jar | 


State | Resource Name 


Eo] Cancel 口 Ora_Driver 
图 8-70 ”选择 对 应 的 驱动 文件 图 8-71 查看 资源 状态 


6) fi “Create New Resource”， 在 弹出 的 菜单 中 选择 “New JDBC Custom DataSource” , 
创建 新 的 JDBC 自 定义 数据 源 ， 如 图 8-72 所 示 。 


Resource List 


Create New Resource a || Delete Selected Resource 
; 


i Deploy New JDBC Driver 

| | New JDBC Custom DataSource 
| New JDBC DataSource Alias 

H New JMS Connection Factory Reference | 


H= New JMS Destination Reference 


|. New JMS Saf Agent Reference 


图 8-72 创建 新 资源 的 类 型 选择 
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7) 在 随后 的 页 面 中 填 人 具体 的 自 定义 数据 源 相 关 配 置信 息 ， 如 图 8-73 所 示 。 配 置信 


息 示例 见 表 8-2。 


表 8-2 配置 信息 示例 
配置 属性 配置 说 明 配置 示例 

Application Name 应 用 名 称 PRO_DS 
DataSource Name 数据 源 名 称 PRO_DS 
Driver Name 驱动 名 称 Ora_Driver (选择 之 前 上 传 驱动 ) 
SQL Engine SQL 引擎 Vendor SQL 
Isolation Level 独立 等 级 Default 
JDBC Version JDBC 版 本 1x (without XA support) 

Driver Class Name 驱动 类 名 称 oracle. jdbc. OracleDriver 
Database URL 数据 库 URL 链接 jdbc: oracle; thin; @ host; port; servicename 
User Name 连接 用 户 名 name 
Password 连接 用 户 密码 pass 


New JDBC Custom DataSource Creation 


Save || Cancel | 
Settings 7 Connection Pooling Additional Properties JDBC DataSource Aliases 

Application Name: PRO_DS 

DataSource Name: * |PRO_DS B 

Driver Name: * Ora_Driver X 

SQL Engine: * Vendor SQL v 

Isolation Level: * Default v 

JDBC Version: * 1x (without XA support) X 


Driver Class Name: * | oracle.jdbc.OracleDriver 


Database URL: * jdbc:oracle:thin:@host:port:servicename| 


User Name: * user 


Password: * eecccece 


图 8-73 输入 资源 信息 


8) 填写 完毕 后 ， 单 击 “Save” 按 钮 进行 保存 ， 在 自 定义 数 
据 源 的 清单 中 就 能 看 到 对 应 的 “PRO_DS” 数 据 源 ， 如 图 8-74 四 
所 示 。 


8.5.2 配置 自 定 义 数据 源 


| ØO PRO_DS 


8-74 


查看 资源 运行 状态 


在 完成 数据 库 驱 动 上 传 以 及 数据 源 的 创建 以 后 ， 下 面 对 该 自 定义 数据 源 进行 更 详细 的 配 


置 ， 以 便 后 续 的 开发 使 用 。 


1) 进入 “JDBC Custom DataSources” 自 定义 数据 ， 选 中 创建 的 “PRO_DS”， 进 入 明细 品 


示 页 面 ， 可 以 看 到 有 “Settings”“Connection Pooling” 和 “JDBC Driver” 等 配置 内 容 。 在 第 一 
个 “设置 ”选项 卡 中 ， 可 以 对 自 定义 数据 源 的 一 些 基 本 信息 进行 修改 ， 如 图 8-75 所 示 。 


2) 在 “Connection Pooling” 选 项 卡 中 可 以 设置 初始 化 连接 数 、 最 大 连接 数 与 获取 连接 超 
时 时 间 。 默 认 使 用 初始 连接 数 “0”， 最 大 连接 数 “25”， 最 长 等 待 时 间 “120”， 如 图 8-76 


所 示 。 
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Resource Details 
> PRO_DS. 4 
JDBC Custom DataSource 

Connection Pooling Additional Properties JDBC Driver DataSource Aliases 

Driver Name: * =| Ora_Driver v 

SQL Engine: * |Vendor SQL X 

Isolation Level: * |Default v 

JDBC Version 1x (without XA support) 
Driver Class Name: * |oracle.jdbc.OracleDriver 


图 8-75 ”设置 明细 信息 
Resource Details 
» PRO_DS. 4 
JDBC Custom De 

Settings J ” Additional Properties, JDBC Driver | DataSource Aliases 
Initial Connections: * 0 图 
Maximum Connections: * 25 
Maximum Time to Wait for Connection: * 120 

C Expiration 


图 8-76 设置 连接 池 信息 
3) Æ “JDBC 驱动 ”选项 卡 中 可 以 更 新 该 自 定 义 数据 源 使 用 的 驱动 ， 如 果 类 型 匹配 错 
误 ， 则 将 无 法 正常 使 用 ， 如 图 8-77 所 示 。 
Resource Details 
> PRO_DS 4 


JDBC Custom DataSource 


‘ Settings Wg Connection Pooling ， 
JDBC Driver Details 


本 State | Resource Name 2 | Resource T 
口 Ora_Driver JDBC Driver 


Additional Properties p < JDBC Driv 


X 


8-77 查看 驱动 资源 


8. 5. 3 ”WD4J 连接 实例 


1) 首先 在 NWDS 中 创建 一 个 Java 的 DC 项 目 ， 新 建 一 个 “Properties”， 如 图 8-78 
所 示 。 


EY [LocalDevelopment] myjav02 
4 src 


4  com.myproject.conn 


b [J] Propertiesjava 


> mÀ JRE System Library [jdk1.6.0_10] 
© cdg 
& def 


BS 


8-78 创建 属性 类 
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2) 添加 以 下 代码 至 属性 类 中 : 


public static String DATASOURCE =" jdbe/PRO_DS" ;//CUSTOM DS 
public static String LOCATION_BASIS ="com. myproject" ; 
public static String DATASOURCEXCEPTION = "获取 数据 源 失 败 ,请 检查 数据 源 是 否 已 启动 " ; 
public static String DATABASEXCEPTION = "数据 库 连 接 异 常 ,请 联系 系统 管理 员 " ; 
public static String UNKWONEXCEPTION = "未 知 错误 ,请 联系 系统 管理 员 " ; 
人 
* return datasource 
ef 
public static String getDataSource( ) | 
return DATASOURCE; 
| 


/** 
x 根据 消息 类 型 返回 错误 消息 
*/ 


public static String getExceptionMsg( String key) | 
if( key. equalsIgnoreCase( " DATASOURCEXCEPTION" ) ) | 
return Properties. DATASOURCEXCEPTION ; 
| else if( key. equalslgnoreCase(" DATABASEXCEPTION" ) ) | 
return Properties. DATABASEXCEPTION ; 
| else} 
return Properties. UNKWONEXCEPTION ; 
| 
| 


3 ) 新 建 “DBConnection” 数据 库 连 接 类 ， 如 图 8-79 所 示 。 


£3 com.myproject.conn 


{J} DBConnectionjava 
[J] Properties.java 


图 8-79 创建 新 的 类 


4) 添加 获取 数据 库 连 接 的 代码 至 连接 类 中 。 


private static final com. sap. tc. logging. Location logger = 
com. sap. tc. logging. Location. getLocation( DBConnection. class) ; 
private static final String DATABASE_JNDI_PROVIDER =" com. sap. engine. services. jndi. InitialCon- 
textFactorylmpl" ; 
private static Context getInitialContext() throws Exception | 
try | 
java. util. Properties properties = null; 
properties = new java. util. Properties( ) ; 
properties. put( Context. INITIAL_CONTEXT_FACTORY, DATABASE_JNDI_PROVIDER) ; 
return new InitialContext( properties ) ; 
| catch( Exception e) | 
logger. errorT ( Properties. getExceptionMsg( " DATASOURCEXCEPTION" ) + e. getMessage( ) ) ; 
throw new Exception( Properties. getExceptionMse(" DATASOURCEXCEPTION" ) ,e) ; 
| 
| 


WR 
+ 根据 jndi 名 ,获得 数据 库 


* @ return 


连接 


* @ throws NamingException 
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* @ throws SQLException 

*/ 

public static Connection getConnection( ) throws Exception | 

try | 

//name = Propertise. getDataSource( ) ; 
Connection conn = null; 
InitialContext jndiCntx = ( InitialContext) getInitialContext( ) ; 
DataSource ds = ( DataSource ) jndiCntx. lookup ( Properties. getDataSource() ) ; 


conn = ds. getConnection( ) ; 
return conn; 
| catch( Exception e) | 


logger. 
errorT ( Properties. getExceptionMsg('" DATASOURCEXCEPTION" ) + e. getMessage() ) ; 


throw new Exception( Properties. getExceptionMsg( " DATASOURCEXCEPTION" ) ,e) ; 


| 
J *¥% 
* @ param conn 
* @ param stmt 
* @ param rs 
*/ 
public static void freeConnection( Connection conn, Statement stmt, 
ResultSet rs) | 
try | 
freeConnection( rs) ; 
freeConnection( stmt) ; 
freeConnection( conn) ; 
} catch( Exception ex) | 
logger. errorT (" 释放 连接 时 出 错 1" + ex. getMessage() ) ; 
| 
| 
public static void freeConnection( Connection conn, Statement stmt) | 
try | 
freeConnection( stmt) ; 
freeConnection( conn) ; 


| catch( Exception ex) | 
logger. errorT ( " 释放 连接 时 出 错 !" + ex. getMessage() ) ; 


| 
| 
public static void freeConnection( Statement stmt, ResultSet rs) | 
try | 
freeConnection(rs) ; 
freeConnection( stmt) ; 
| catch( Exception ex) | 
logger. errorT (" 释放 连接 时 出 错 1" + ex. getMessage() ) ; 
| 
| 
public static void freeConnection( Connection conn) f 
try | 
if(conn!= null) 
conn. close( ) ; 


} catch ( SQLException ex) | 
logger. errorT (" 释放 连接 时 出 错 !" + ex. getMessage() ) ; 
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public static void freeConnection( Statement stmt) | 
try | 
if( stmt! = null) 
stmt. close( ) ; 
| catch( SQLException ex) | 
logger. errorT (" 释放 连接 时 出 错 1" + ex. getMessage() ) ; 
| 
} 
public static void freeConnection( ResultSet rs) | 
try | 
if(rs!= null) 
rs. close( ) ; 
| catch( SQLException ex) | 
logger. errorT (" 释放 连接 时 出 错 !" + ex. getMessage() ) ; 
| 
} 


5) 接着 创建 实体 Bean “EntityBean” 和 “EntityDao” 访 问 数据 库 ， 分 别 建 立 “User” 


与 “UserDao” 类 ， 如 图 8-80 所 示 。 


6) 在 “User” 类 中 添加 相应 的 字段 属性 和 默认 的 “get” 以 及 “set” 构 造 方法 ， 如 图 8-81 


所 示 。 


4 © User 
a id 
A name: String 
a icode : String 
4 器 src © getId0 : String 
4 册 com.myproject.bean ©  setid(String) 
| 加 User.java » getName0 
出 com.myproject.conn © setName(String) 
4 [8 com.myproject.dao © geticode() : String 
6 UserDao,javal ə seticode(String) 


图 8-80 创建 新 的 类 图 8-81 创建 字段 对 应 的 构造 方法 


7) 在 “UserDao” 中 添加 以 下 方法 : 


/** 

* 查询 用 户 

* 

* @ return 

*/ 

public static List findUser( ) | 

Connection conn = null; 

PreparedStatement prepareStatement = null; 
ResultSet rs = null; 


String sql =""; 
List < User > userList = null; 
try | 


sql = "select * from T_USER" ; 

conn = DBConnection. getConnection( ) ; 
prepareStatement = conn. prepareStatement( sql) ; 
rs = prepareStatement. executeQuery( ) ; 

userList = new ArrayList < User > ( ) ; 

while( rs. next() ) | 
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User user = new User( ) ; 

user. setId(rs. getString("ID" ) ) ; 

user. setlcode( rs. getString( " ICODE" ) ) ; 
user. setName(rs. getString( "NAME" ) ) ; 
userList. add( user) ; 


| 


| eatch( Exception e) ! 


logger. errorT("sql:" +sql +". 查询 用 户 表 异 常 ." +e. getMessage( ) ) ; 
| finally | 
DBConnection. freeConnection( conn, prepareStatement, rs) ; 


| 
| 


8) 切换 至 NWDI AY “Development Infrastructure” WEI, A Java 工程 ， 定 义 “Public 
Part” 公 共 部 分 ， 并 将 外 部 需要 访问 的 类 添加 到 公共 部 分 中 ， 如 图 8-82 所 示 。 

9) 在 “MyComponents” 中 创建 一 个 EAR 项 目 ， 并 添加 Java 工程 的 依赖 。 这 是 由 于 在 
SAP NetWeaver 平台 中 不 能 直接 发 布 Java 工程 ， 必 须 通 过 EAR 项 目 进行 打包 并 发 布 ， 如 图 8-83 
所 示 。 


return userList; 


Defined Public Parts 
Specify the list of public parts for this DC Required DCs 
a (E api] | 
@& com 
中 com 
4 E ass 
@& com 


@& com 


Al 8-82 ”添加 公共 部 分 网 8-83 依赖 工程 明细 1 


10) 下 面 介 绍 如 何在 Web Dynpro 中 调用 自 定 义 数 据 库 的 这 些 连 接 方法 并 获取 数据 。 首 
先 创 建 一 个 新 的 Web Dynpro 工程 ， 并 在 DI 视图 中 的 “Dependencies” 依 赖 中 添加 对 于 EAR 
工程 的 依赖 ， 如 图 8-84 所 示 。 


Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the sele 
| Bn myear03) 出 口 Design Time 
4 Dee myjav02 
E api Add... Deploy Time 
R ass Re a 
move w ime > ~ 
Da tc/aii/base/offline/facade W Runtime strong 


Al 8-84 依赖 工程 明细 2 


11) 在 DI 视图 中 的 “Dependencies” 依 赖 中 添加 对 于 Java 工程 的 依赖 ， 如 图 8-85 所 示 。 


Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the sele 
oam an HE Design Time 
4 || Der myjav02 | 
Add.. Deploy Time 
G@ ass Remove á 
Da tc/aii/base/offline/facade Runtime strong 本 


网 8-85 依赖 工程 明细 3 
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12) 接着 回 到 Web Dynpro 视图 ， 并 创建 对 应 的 Java Bean 模型 ， 右 击 “Models”， 并 选 
择 新 建 模 型 ， 在 弹出 的 对 话 框 中 选择 “Java Bean Model”， 随 后 单 击 “Next” 按 钮 ， 如 图 8-86 
所 示 。 

13) 选择 JavaBean 的 源 文件 ， 选 择 来 自 于 其 他 DC 的 公共 部 分 ， 随 后 单 击 “Next” 按 
钮 ， 如 图 8-87 所 示 。 


® Adaptive RFC 2 Model 


Jĝ Adaptive Web Service Model Select JavaBean Source 
3 Enterprise JavaBean Model 5 Project (Source Folder) 
{§3 Java Bean Model 

E? Adaptive RFC Model - DEPRECATED 


图 8-86 选择 模型 类 型 8-87 选择 JavaBean 源 文件 类 型 


14) 选中 需要 引用 的 公共 部 分 ， 单 击 “Next” 按 钮 ， 如 图 8-88 所 示 。 
15) 选择 需要 使 用 的 具体 Java 类 ， 并 单 击 “Add” 按 钮 ， 如 图 8-89 所 示 。 


© DBConnection - com.myproject 


© Properties - com.myproject.cor 


a [V] Sj myjav02 [demo.sap.com] 


MES api 2 User - com.myproject.bean | 
DE ass UserDao - com.myproject.dao 
AE 


图 8-88 选择 对 应 的 公共 部 分 图 8-89 选择 对 应 的 类 


16) 完成 所 有 配置 后 ， 单 击 “Finish” 按 钮 ， 随 后 可 以 在 项 目 目录 中 看 到 成 功 导 入 的 模 
型 ， 如 图 8-90 所 示 。 

17) 接着 在 视图 中 创建 对 应 属性 的 相关 上 下 文 ， 创 建 “User” 结 点 和 3 个 字符 串 类 型 的 
特性 ， 以 用 于 获取 数据 测试 ， 如 图 8-91 所 示 。 


kb 过 Models C) User 
4 83 UserModel 日 icode 
日 id 
A namg 
图 8-90 ”导入 模型 后 的 效果 8-91 创建 上 下 文清 单 


18) 接着 在 视图 中 创建 对 应 属性 ， 右 击 “Outline” 中 的 根 结 点 ， 选 择 “ Apply Tem- 
plate”， 随 后 创建 对 应 上 下 文 的 表格 元 素 ， 如 图 8-92 所 示 。 


ih id name icode 

[| |@a @name @icode 
[| @id @name @icode 
| | @id @name @icode 


WR] 


8-92 创建 表格 元 素 


19) 进入 Web Dynpro 视图 控制 器 的 Java 编辑 器 ， 在 “wdDomit” 初 始 化 方法 中 编写 访 
问 数 据 层 的 逻辑 进行 获取 数据 测试 ， 添 加 如 下 代码 : 
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List findUser = UserDao. findUser( ) ;// 访 问 Dao 

wdContext. nodeUser( ). invalidate( ) ;// 清 空 数据 

for(int i =0;i <findUser. size( ) ;i += ) | 
[UserElement createAndAddUserElement = wdContext. nodeUser( ) 
. createAndAddUserElement( ) ;//Create Element 
User user = ( User) findUser. get(i) ;// 赋 值 
createAndAddUserElement. setId( user. getId() ) ; 
createAndAddUserElement. setIcode( user. getIcode( ) ) ; 
createAndAddUserElement. setName( user. getName( ) ) ; 


| 


20) 完成 所 有 代码 编写 后 ， 编 译 、 部 署 相 关 工 程 (包括 Web Dynpro WA, EAR 项 目 以 
及 Java 项目) ， 运 行 应 用 程序 后 ， 就 能 看 到 对 应 的 测试 数据 了 ， 如 图 8-93 所 示 。 


"| id name icode 
| 4 Gemy 1001 


图 8-93 运行 效果 


8.6 Java 属性 类 的 应 用 


Java 中 有 一 个 比较 重要 的 类 “Java. util. Properties”， 主 要 用 于 读 取 Java 的 配置 文件 环境 
变量 。 配 置 文件 是 扩展 名 为 “. properties” 的 文件 ， 可 以 通过 记事 本 或 写字 板 直接 进行 编 
辑 ， 也 可 以 在 NWDS 中 直接 进行 修改 。 文 件 中 内 容 的 格式 是 “ 键 = 值 ” 的 格式 ,文本 注释 
信息 则 通过 “#” 来 进行 标记 。 

对 于 一 般 的 Java 项 目 或 2EE 工程 来 说 ， 在 调整 属性 时 直接 修改 “. properties” 文 件 即 
可 ; {HÆ SAP NetWeaver 平 台中， 则 是 通过 NWA 平台 进行 属性 的 修改 。 下 面 通过 一 个 实例 
来 进行 SAP NetWeaver 平台 中 的 属性 类 的 应 用 ,包括 设计 时 的 开发 和 运行 时 的 调整 两 部 分 
内 容 。 

实例 中 配置 的 是 服务 器 名 和 服务 器 端口 两 个 属性 ， 配 置 这 两 个 属性 的 原因 是 很 多 应 用 程 
序 在 逻辑 处 理 时 需要 访问 服务 器 的 功能 ， 但 由 于 SAP NetWeaver 架构 中 的 硬件 配置 ， 在 应 用 
从 开发 机 传输 至 测试 机 、 生 产 机 的 过 程 中 经 党 需要 变更 服务 器 的 链接 信息 ， 在 使 用 Java E 
性 类 后 ,每 次 修改 不 再 需要 开发 人 员 对 代码 进行 维护 ， 普 通 的 运 维 管理 人 员 就 可 在 NWA 端 
完成 配置 变更 。 


8. 6.1 设计 时 配置 


在 开发 过 程 中 ， 将 创建 一 个 EJB 工程 ， 用 于 包含 对 应 的 属性 文件 以 及 读 取 该 属性 的 公 
共 方 法 。 

开发 实例 : 

1) 打开 NWDS 开发 者 工作 室 ， 切 换 到 “Java EE” 透 视图 ， 如 图 8-94 所 示 。 

2) 分 别 创建 一 个 EJB 和 一 个 EAR 工程 ， 命 名 为 “myejb04” 和 “myear05”， 如 图 8-95 
所 示 。 
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43 myear05 
(Ea Deployment Descriptor: myear05 


(& EarContent 


。 a && myejb04 
H Enterprise Portal =a r s 
ao : ices R A (gu Deployment Descriptor: myejb04 
= Enterprise Services Repository 2 JAX-WS Web Services 
oa > E ejbModule 


Sl Java Browsing BA JRE System Library [jdk1.6.0_30] 
FS Java EE | mA SAP Java EE 5 Libraries 

fe? Java Type Hierarchy mA EAR Libraries 

© build 


& JavaScript 


图 8-94 切换 透视 图 图 8-95 创建 项 目的 目录 结构 


3) 展开 EAR 工程 ， 右 击 “META -INF” 文 件 来 ， 并 选择 “New”， 随 后 选择 “File”， 
创建 新 文件 ， 输 入 文件 名 “sap. application. global. properties”， 如 图 8-96 所 示 。 

4) 在 文件 中 定义 环境 变量 。 本 实例 中 定义 了 两 个 环境 变量 “SERVER_NAME” 与 
“SERVER_PORT”， 即 服务 器 名 和 端口 号 ， 如 图 8-97 所 示 。 配 置 文件 代码 参考 如 下 : 


## SERVER_NAME 

#? onlinemodifiable = true; 

#% type =STRING; 

SERVER_NAME = dev01. domain. com. cn 


## SERVER_PORT 

#? onlinemodifiable = true; 
#% type =STRING; 
SERVER_PORT =50100 


|- META-INF 
x application-jZee-engine. xml 
B sap. application. global. properties 


8-97 ”添加 代码 


TF 


图 8-96 创建 配置 文人 
在 EJB 中 编写 代码 获取 属性 文件 的 配置 参数 值 。 首 先 新 建 一 个 EJB， 如 图 8-98 所 示 。 


EJB project: [LocslDevelopment “mye jb04” demo. sap. com x] 
Source folder: [/LocalDevel opment myejb04” demo. sap. com/ejbModule 


Java package: feom. myproject. proper 
Class name: JappCfgBean 
Superclass: | 


State type: [Stateless z] 


Create business interface 


J Remote feom myproject. proper. åppCfgBeanRemote 
IV Local Jcom. myproject. proper. AppCfgBeanLocal 


图 8-98 输入 EJB 信息 
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5) 接着 在 接口 中 新 定义 获取 属性 方法 ,参考 代码 如 下 : 


getAppValue( String key) ; 


@ Local 

public interface AppCfgBeanLocal | 

/** 

* 根据 关键 字 从 properties 文件 里 获得 变量 值 
* 


* @ param key 

* @ return 

*/ 

public String getAppValue( String key) ; 
| 


6) 在 Session Bean 中 编写 实现 逻辑 , 


@ Override 
public String getAppValue( String key) | 
//TODO Auto - generated method stub 
String appValue ="" ; 
try | 
InitialContext ctx = new InitialContext( ) ; 
ApplicationPropertiesAccess appPropAcs = ( ApplicationPropertiesAccess ) ctx 
. lookup( " ApplicationConfiguration" ) ; 
java. util. Properties appProp = appPropAcs 
. getApplicationProperties() ; 
if(null!= appProp &&!"". equals( key) ) | 
appValue = ( String) appProp. get( key) ; 
| 
| catch( NamingException e) | 
// 系 统 日 志 
// 需 添加 tec/je/appconfiguration/api 与 logging 的 依赖 
logger. errorT(" 系统 应 用 参数 配置 异常 " +e. getMessage( ) ) ; 
| 


| 


return appValue; 


7) 编写 工具 类 访问 EJB， 添 加 类 “com. myproject. util. AppPropUtil” : 


/** 
* 根据 关键 字 从 properties 文件 里 获得 配置 内 容 


* @ param key 
* 参数 名 称 
* @ return 
*/ 
public static String getAppConfByKey( String key) | 
String value =""; 
try | 
InitialContext ctx = new InitialContext( ) ; 
String jndi = " demo. sap. com/myear05/LOCAL/ AppCfgBean/ 
com. myproject. proper. AppCfgBeanLocal" ; 
AppCfgBeanLocal local = ( AppCfgBeanLocal ) ctx. lookup (jndi) ; 
value = local. getAppValue( key) ; 
} catch( NamingException e) | 
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人/ 记录 系统 日 志 
logger. errorT(" 系统 应 用 参数 配置 出 现 异常 " +e. getMessage( ) ) ; 


| 


return value; 


| 
8) 添加 Util 类 至 公共 部 分 ， 以 便 其 他 应 用 程序 进行 公共 方法 的 调用 ， 如 图 8-99 所 示 。 


Defined Public Parts 

Speci fy the list of public parts for this DC 

=) [EF iclient! Add... 
T er ERN 

全 AppCfeBeanLocal 


| ct com. myproject. util 
| 


S-  eibier 
出 com. myproject. util 


© demo. sap. com mye jb04 


图 8-99 ”定义 公共 部 分 


9) 编译 、 部 署 EAR 项 目 后 ， 在 Web Dynpro 项 目 中 就 可 以 通过 APL 的 使 用 获取 属性 文 
件 中 的 值 ，Web Dynpro 参考 代码 如 下 : 


//get system properties server_name 

String appConfByKey = AppPropUtil. getAppConfByKey( "SERVER_NAME" ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess( 

"SERVER_NAME," + appConfByKey) ; 


10) i247 Web Dynpro 应 用 程序 后 ， 就 能 打印 出 获取 的 属性 值 ， 如 图 8-100 所 示 。 
wW SERVER_NAME:dev01.domain.com.cn 


Al8-100 提示 消息 


8. 6.2 ”运行 时 调整 


将 相应 的 属性 文件 部 署 至 Java 应 用 服务 器 后 ， 当 需要 修改 时 ， 可 直接 通过 NWA 对 配置 
文件 进行 修改 和 更 新 。 

开发 实例 : 

1) 使 用 管理 员 账 户 登录 NWA 平台 ,选择 “Configuration” 一 “了 nfrastructure”， 单 击 
“Java System Properties” 链 接 ， 如 图 8-101 所 示 。 

2) 搜索 对 应 的 EAR 名 称 ， 支 持 模 糊 查 询 ， 如 图 8-102 所 示 。 


Details about ZATPL AIO 
Kernel Services Applications 


More Actions 4 
i | F Name 
En Java System Properties z = 
三 图 Important configuration data of the selected syste YP *myear0S 
D 


A small number of properties are modifiable online. m] myear05 


KI 8-101 单 击 链接 图 8-102 查询 对 应 的 应 用 程序 


3) 选择 对 应 的 EAR 项 目 后 ， 在 下 方 的 属性 页 签 中 就 能 看 到 对 应 的 属性 名 称 ， 如 图 8-103 
所 示 。 
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Extended Details 
Properties | 
| Save || Restore Defautt | | [ Modify] | [ Show Details 
T| Name 
? 
| | SERVER_NAME 
| SERVER_PORT 


= | Default Calculated Value 


dev01.domain.com.cn 
50100 


8-103 ”找到 配置 文件 的 属性 


4) 单 击 选中 “SERVER_NAME”， 单 击 “Modifyg” 按 钮 ， 在 弹出 的 对 话 框 中 输入 需要 修改 
的 新 值 “dev02. domain. com. cn”， 随 后 单 击 “Set” 按 钮 ， 如 图 8-104 所 示 。 


Modify Property Value 


Enter Custom Value: [dev01.domain.com.cn 


HI 


到 8-104 ”修改 属性 值 的 对 话 和 


5) 对 话 框 设置 完成 后 ， 还 需要 单 击 “Save” 按 钮 保存 修改 ， 如 图 8-105 所 示 。 


Default Calculated Value Modifiable Online Custom Calculated Value 


dev01.domain.com.cn v ea 


图 8-105 ”修改 后 的 效果 


6) 再 次 运行 Web Dynpro 测试 程序 ， 打 印 出 更 新 后 的 属性 文件 的 对 应 值 ， 如 图 8-106 所 示 。 


fA SERVER_NAME:dev02.domain.com.cn 


图 8-106 提示 消息 


8.7 志 管 理 


在 实际 的 项 目 应 用 中 ,日 志 的 记录 以 及 跟踪 非常 重要 ， 尤 其 是 紧急 性 的 排 错 等 问题 对 于 
日 志 的 依赖 更 是 很 大 ， 因 此 需要 掌握 程序 开发 过 程 中 日 志 记 录 的 方法 ， 并 且 规 范 地 记录 
Web Dynpro 应 用 程序 中 或 是 BPM 业务 流程 中 关键 动作 或 步骤 产生 的 日 志 。 


8.7.1 设计 时 日 志 记录 
对 于 新 建 的 Web Dynpro 项 日 ， 在 切换 到 DI 透视 图 后 ， 可 以 在 默认 的 “Dependencies” 
项 目 依 赖 的 选项 卡 中 发 现 已 默认 添加 了 对 “tc/bl/logging/api” 标 准 开 发 组 件 的 依赖 。 该 开 
发 组 件 包 含 了 日 志 记 录 的 公共 类 及 相关 方法 ， 如 图 8-107 所 示 。 
在 Web Dynpro 的 任意 一 个 视图 中 ， 也 能 找到 默认 的 日 志 记 录 的 实例 “logger”， 如 图 8-108 
所 示 。 
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#8 =com.sap.demo.mydynp05.wd.comp.dynp05_! 
“= import declarations 
4 © Dynp05_01Comp_04View 
FF serialVersionUID : long 


Required DCs 
Specify the list of DCs required for this DC 


ee logger : Location 


Da te/aii/base/offline/facade las 

Da tc/bl/exception/lib a {.} 

[Da tc/bl/logging/api ap F wdThis : IPrivateDynp05_01Comp_04Viev 
Ba tc/cmi a F wdContext : IContextNode 

Ba tc/ddic/runtime/facade ge’ wdControllerAPI : IWDViewController 
Da tc/wd/api a9 © wdComponentAPI : IWDComponent 


K 8-107 依赖 项 目 清单 图 8-108 默认 的 日 志 记录 类 


默认 的 定义 代码 ， 如 图 8-109 所 示 。 


/** 
* Logging location. 
*/ 

@SuppressWarnings ("unused") 

private static final com.sap.tc.logging.Location logger = 
com.sap.tc.logging.Location.getLocation(Dynp05_01iComp.class) ;| 


Z| 8-109 标准 定义 代码 


在 这 些 标准 类 和 参数 的 支持 下 ， 在 Web Dynpro en ， 都 可 
以 直接 使 用 标准 的 日 志 类 来 进行 运行 日 志 的 记录 。 根 据 日 志 级 别 的 高 低 ，logger 类 分 别提 供 
了 不 同 的 记录 方法 ， 如 图 8-110 所 示 。 
logger. warningT(" 操作 记录 警告 1" ) ;// 记 录 warning 级 别 的 日 志 


logger. infoT(" 操作 记录 成 功 1" ) ;// 记 录 info 级 别 的 日 志 
logger. errorT(" 操作 记 录 失 败 1" ) ;// 记 录 error 级 别 的 日 志 


public void onActionLog(com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 
{ 
//@@begin onActionLog (ServerEvent) 
logger.warningT ("操作 记录 敬告 1") ;// 记录 warning 级 别 的 日 志 
logger.infoT ("操作 记录 成 功 !");// 记录 info 级 别 的 日 志 
logger.errorT《" 操 作 记录 失败 !1") ; // 记录 erroz 级 别 的 日 志 | 


//@@end 
} 


ES 


8-110 不 同类 型 日 志 记录 示例 


需要 注意 的 是 ,在 使 用 以 上 代码 时 ， 针 对 SAP 的 Web Dynpro 项 目 会 默认 添加 日 志 组 件 
的 依赖 ， 而 对 于 其 他 类 型 的 项 目 ， 则 需要 手工 添加 对 于 日 志 类 的 依赖 ， 并 初始 化 logger X 
例 ， 之 后 才能 通过 “warningT” 等 方法 进行 日 志 记 录 。 


8.7.2 运行 时 日 志 查 看 


对 于 应 用 程序 运行 时 的 日 志 查 看 ，NWA 中 提供 了 统一 的 查看 日 志 视 图 ， 进入 NWA F 
台 ， 找 到 “Troubleshooting” 一 “Logs and Traces” — “Log Viewer”， 如 图 8-111 所 示 。 
随后 在 菜单 中 选择 “View” 一 “Open View” — “Developer Traces”, MI] 8-112 所 示 。 
刷新 能 够 不 断 看 到 最 新 的 日 志 ， 可 以 使 用 “Advanced Filter” 高 级 过 滤器 对 日 志 做 进一步 
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My Workspace { Availability and Performance | Operations | Configuration Troubleshooting SOA | 


Java | Database Log ces Processes and Tasks Advanced Troubleshooting 


Log Configuration ( Log Viewer } 
oY Te Log Coto The Log Configuration plug-in provides functionality for inspecting the log configuration, changing the ‘Using the Log Viewer plug-in, you can gather information about system 
severity of log controllers, and resetting the current log configuration to the default one Oo records logged by applications or servers. Careful monitoring of logs can 


identify the sources of system problems.Use predefined perspectives an| 
BO Security Troubleshooting Wizard the process of gathering desire information 
= The Security Troubleshooting Wizard is scenario-oriented diagnostic tool for any reproducible 
OB security-related problems. The automatically-generated report can be downloaded and sent to the 
support team for further processing 


Al8-111 NWA 平 台中 的 日 志 查 看 器 


Favorites, Related Links GoTo% Support Details 


View, Log Files , 

Open View … >) <Create New View> 

Open Expert View SAP Logs 

Connect to Remote System System Logs and Traces 
Developer Traces 
Unstructured Log Files 

3 € Change Log 
Save View As Uploaded Log Files 


Http Response 
Authentication Logs 


Security Log 


图 8-112 查看 开发 日 志 的 菜单 选择 


地 筛选 与 过 滤 ， 也 可 以 在 表格 最 上 放 的 输入 框 中 输入 关键 字 进 行 模糊 查询 ， 如 图 8-113 所 示 。 


Time Message 


15:32:56:389 ”操作 记录 失败 ! 


图 8-113 查看 新 日 志 记 录 


jE: Æ Web Dynpro 测 试 中 ， 同时 记录 了 消息 、 警 告 和 错误 ， 但 由 于 默认 的 日 志 级 别 设 
置 ， 因 此 此 处 只 能 看 到 错误 消息 。 


8.7.3 日 志 级 别 配置 


由 于 不 同系 统 的 体 量 不 同 ， 以 及 需要 记录 的 日 志 具 体 要 求 也 不 尽 相 同 ， 所 以 需要 针对 不 
同 的 情况 进行 个 性 化 的 日 志 级 别 配 置 ， 以 此 优化 日 志 使 用 效率 和 服务 器 硬盘 容量 负载 。 

在 实际 项 目 开 发 中 ， 对 于 日 志 记 录 最 低 的 要 求 是 记录 错误 级 别 的 日 志 ， 特 别 是 对 于 应 用 
程序 异常 或 者 接口 功能 报错 等 都 需要 有 对 应 的 后 台 日 志 ， 以 便 进行 追踪 和 定位 ;同时 对 于 代 
码 的 调试 或 者 功能 测试 ， 也 经 常 需要 将 操作 日 志 ， 即 消息 级 别 的 日 志 记 录 下 来 。 

由 于 实际 的 生产 环境 ， 往 往 会 有 大 量 的 业务 数据 运行 ， 这 期 间 也 会 产生 庞大 的 日 志 
FE, IRS ae et H 志文 件 的 频繁 操作 会 大 大 是 多 响 其 性 能 ， 所 以 建议 对 于 生产 环境 采用 默认 的 错 
误 级 别 ， 而 在 开发 或 测试 环境 中 ， 可 以 调整 配置 为 信息 级 别 ， 以 提供 对 开发 人 员 更 好 的 
Sits 

配置 实例 : 

1) 进入 NWA 平台， 找到 “Troubleshooting” 一 “Logs and Traces” — “Log Configura- 
tion”， 如 图 8-114 所 示 。 
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“My Workspace | Availability and Performance | Operations | Configuration Troubleshooting | SOA | 


base | ee | nn a A E 


Java | 


Log Configuration uration og Viewer 
gre Tae Log Configuration plug-in provides functionality for inspecting the log configuration, changing the Using the Log Viewer plug-in, you can gather information about system problems and monitor all log 
severity Flog controllers, and resetting the current log configuration to the default one {lia records logged by applications or servers. Careful monitoring of logs can help you to predict and 
identify the sources of system problems.Use predefined perspectives and right filters to speed up 
[E Q Secuity Troubleshooting Wizard the process of gathering desire information. 
The Security Troubleshooting Wizard is scenario-oriented diagnostic tool for any reproducible 


Q D security-related problems. The automatically-generated report can be downloaded and se 
support team for further processing. ST 


图 8-114 NWA 平 台中 的 日 志 配 置 
2) 选择 “Tracting Locations” 并 输入 确切 的 日 志 记 录 位 置 ， 如 图 8-115 所 示 。 


Favorites, RelatedLinks, GoTo, Support Details 
ve 


Show: Tracing Locations ”| Location: h.sap.demo.mydynp05.wd| | Go Open Filter 


Tracing Locations 


Save Configuration Reset Location || Copy to Subtree || Copy To Filtered Subtree || Default Configuration 


图 8-115 日 志 记 录 位 置 的 操作 界面 


3) 单 击 “Go” 按 钮 ， 在 弹出 的 对 话 框 中 选择 项 目的 根 目 录 ， 单 击 “OK” 按 钮 ， 如 
图 8-116 所 示 。 


Total 7 occurrences found 

T | Location 2 4 Bj 
com.sap.demo.mydynp05.wd z 
com.sap.demo.mydynp05.wd.comp 
com.sap.demo.mydynp05.wd.comp.dy... 
com.sap.demo.mydynp05.wd.comp.dy... 
com.sap.demo.mydynp05.wd.comp.dy... 
com.sap.demo.mydynp05.wd.comp.dy... 


com.sap.demo.mydynp05.wd.comp.dy... 


图 8-116 选择 对 应 目录 


4) 在 默认 情况 下 ， 对 应 目录 的 日 志 级 别 是 “Error”， 即 错误 级 别 。 对 它 进行 重新 设置 ， 
可 以 显示 级 别 较 低 的 开发 日 志 ， 如 图 8-117 Bras, 


| hd (f=) demo g Error ~ Inherited From Parent 
| | X e] mydynp05 @ Error v Persisted Configuration 
pa d Clim @W Eror v Inherited From Parent 
m > Q comp @ Eror w Inherited From Parent 


图 8-117 查看 日 志 配 置 级 别 


5) 将 “wd” 目 录 的 日 志 级 别 修改 为 “Warning”， 即 警告 级 别 ， 单 击 “Copy to Subtree” 
应 用 到 所 有 子 目录 中 ， 随 后 单 击 “Save” 对 配置 进行 保存 ， 如 图 8-118 所 示 。 


| =] demo @ Error ~ Inherited From Parent 
四 | v 回 mydynp05 ao 2 @ Eror v Persisted Configuration 
国 ~ Owd a Warning œ Persisted Configuration 
四 > Q comp H| Warning v Inherited From Parent 


图 8-118 修改 日 志 配 置 级 别 
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6) 再 次 运行 Web Dynpro 程序 后 ， 刷 新 日 志 视 图 ， 同 时 显示 了 错误 和 和 警告， 如 图 8-119 
所 示 。 


Time Message 


15:46:03:438 | 操作 记录 失败 ! 


15:46:03:437 | HIFICRS A! 


图 8-119 查看 日 志 记录 


7) 再 次 修改 目录 的 日 志 级 别 ， 选 择 “Info” 消 息 级 别 并 保存 ， 如 图 8-120 所 示 。 


v demo @ Eror v Inherited From Parent 
| v Omydynp05 ee @ Eror v Persisted Configuration 
ews ~ Owd 这 [i] Info + Persisted Configuration 

| > Q comp G) Info v Inherited From Parent 


图 8-120 修改 日 志 配 置 级 别 


8) 再 次 运行 程序 并 刷新 日 志 视图 ， 即 可 同时 显示 3 种 级 别 的 日 志 ， 如 图 8-121 所 示 。 


图 8-121 查看 日 志 记录 
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PIR FEIE 


在 了 解 SAP 的 开发 基础 架构 之 前 ， 先 来 看 下 一 些 传 统 项 目的 团队 Java 开发 状况 : 团队 
在 开发 时 需要 手动 地 更 新 Java 类 库 ， 在 本 地 开发 并 完成 代码 编写 后 手动 地 将 项 目 发 布 至 测 
试 服务 器 进行 测试 运行 ; 在 多 人 协作 时 容易 出 现 类 库 不 一 致 、 不 同 开 发 人 员 负 责 的 功能 代码 
难以 融合 等 问题 ; 团队 在 各 自 提 交代 码 进 行程 序 更 新 或 升级 时 没有 系统 或 平台 支持 ， 运 维 人 
员 难 以 对 开发 人 员 独 立 的 部 署 更 新 进行 有 效 地 管理 和 监控 。 比 较 常 见 的 问题 如 下 : 

1) 在 开发 阶段 没有 同步 最 新 的 代码 进行 使 用 。 

2) 在 匹配 外 部 Java 类 库 时 未 使 用 最 新 版 本 ， 或 多 个 开发 成 员 使 用 的 版 本 不 一 致 。 

3) 由 于 没有 完整 的 载 人 ， 所 有 的 必要 依赖 工程 导致 本 地 编译 出 错 。 

4) 多 个 开发 人 员 修 改 同一 功能 导致 代码 冲突 。 

5) 本 地 编译 与 服务 器 端 编 译 结果 不 一 致 。 

6) 开发 工程 环境 不 一 致 ， 或 测试 服务 器 配置 差异 ， 导 致 运行 结果 不 一 致 。 

7) 定位 问题 、 解 决 文件 冲突 、 同 步 代 码 和 类 库 等 工作 过 程 元 长 枯燥 。 

为 了 解决 这 一 系列 的 问题 ， 提升 开发 团队 的 工作 效率 ，SAP 推出 了 SAP NetWeaver F 
发 基础 架构 (SAP NetWeaver Development Infrastructure，NWDI) ， 它 提供 给 了 开发 人 员 尤 
其 是 开发 团队 一 个 强大 的 集成 化 开发 平台 。 它 可 以 覆盖 整个 项 目的 开发 周期 ， 涵 盖 了 从 
设计 、 开 发 、 编 译 、 发 布 、 同 步 到 更 新 等 内 容 范 围 。 由 于 代码 的 集成 管理 以 及 开发 环境 
的 高 度 统一 ， 避 免 了 各 自 单 独 开发 时 的 同步 问题 和 更 新 问题， 加速 了 团队 整体 的 开发 进 
度 ; 平台 的 运行 环境 已 集成 在 Java 开发 人 员 熟 悉 的 ， 以 Eclipse 为 核心 的 开发 工具 中 ， 并 
支持 各 种 各 样 的 SAP NetWeaver 平台 的 Java 相关 项 目 创 建 、 编 译 以 及 部 署 服务 器 工作 ;可 
靠 的 传输 同步 机 制 ， 并 且 有 强大 的 SAP NetWeaver 平台 对 传输 请 求 以 及 代码 版 本 进行 统一 
的 监控 和 管理 。 

如 果 接 触 过 SAP ABAP 开发 ， 在 使 用 了 NWDI 以 后 ， 一 定 会 有 一 种 似 兽 相识 的 感 党 。 从 
某 种 意义 上 来 说 ，SAP 正 是 想 要 将 ABAP 开发 中 的 一 整套 管理 机 制 搬 到 它 想 要 涉足 的 Java 
世界 中 。 例 如 ， 传输 请 求 、“Check in” M “Check out” 动 作 、 冲 突 代 码 整 合 、 代 码 的 版 本 
管理 和 比较 、 传 输 管 理 和 监控 ， 这 些 NWDI 中 的 种 种 功能 特性 其 实 都 能 在 SAP 的 ERP 系统 
中 找到 一 些 可 以 追寻 的 踪影 ， 见 表 9-1。 


表 9-1 SAP 中 Java 5 ABAP 开发 的 相似 之 处 


不 同 开发 阶段 SAP 中 的 Java 开发 SAP 中 的 ABAP 开发 

开发 环境 准备 登录 NWDI 的 开发 控件 登录 SAP 开发 系统 (W ECC) 

面向 团队 开发 复制 、 下 载 源 代 码 ， 进 行 相关 开发 工作 修改 并 同时 锁定 开发 对 象 
代码 调试 基于 NWDI 服务 端 环境 进行 编译 ， 激 活 更 改 激活 代码 修改 
集成 测试 与 NWDI 架构 一 致 的 环境 中 测试 应 用 程序 在 SAP 系统 中 直接 进行 代码 或 应 用 运行 测试 
统一 运行 释放 请 求 并 进行 传输 释放 请 求 并 进行 传输 
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9.1 NWDI 的 组 成 


在 NWDI 整个 架构 中 ， 包 含 了 DTR, CBS, CMS, SLD 和 NWDS 等 几 个 部 分 。 

e DTR (Design Time Repository， 设 计时 资源 库 ) 用 于 存储 所 有 的 代码 文件 对 象 。 

e CBS (Component Build Service， 组 件 编 译 服 务 ) 用 于 存放 服务 器 端 开发 环境 的 所 有 类 
库 ， 也 用 于 编译 和 存放 所 有 新 创建 的 开发 组 件 。CBS 与 DTR 紧密 集成 在 NWDI 中 。 
e CMS (Change Management Service ， 变 更 管理 服务 ) 用 于 对 所 有 开发 对 象 的 变更 管理 。 
e SLD (System Landscape Directory， 系 统 场景 目录 ) 用 于 定义 源 代码 运行 环境 的 服务 器 
版 本 、 所 用 到 的 具体 产品 、 所 用 到 的 具体 软件 组 件 。 严 格 来 说 ，SLD 并 不 属于 NW- 
DI, 但 是 NWDI 的 运行 依赖 于 SLD 的 环境 配置 。 

e NWDS INX SAP NetWeaver 开发 者 工作 室 ， 相 关 介 绍 可 参考 本 书 第 1 章 内 容 。 

SAP 中 Java 和 ABAP 开发 的 环境 比较 见 表 9-2, 


表 9-2 SAP Java 和 ABAP 开发 的 环境 比较 


场景 和 功能 SAP 中 的 ABAP 开发 SAP 中 的 Java 开发 
编辑 器 系统 中 的 对 象 导 航 顺 〈SE80 ) SAP NetWeaver 开发 者 工作 室 (NWDS) 
编译 吉 系统 核心 功能 NWDI 中 的 CBS 服务 
运行 时 环境 ERP 服务 器 实例 SAP NetWeaver 服务 器 实例 
代码 版 本 管理 系统 中 的 版 本 管理 NWDI 中 的 DTR 资源 库 
传输 机 制 传输 管理 系统 (STMS ) NWDI 中 的 CMS 服务 


由 表 9-2 可 以 看 出 ，SAP 迫切 想 要 通过 NWDI 将 ABAP 开发 中 成 熟 的 管理 模式 和 成 功 的 
开发 经 验 复制 到 Java 开发 中 。 下 面 介 绍 整个 NWDI 的 布局 架构 将 如 何 覆 盖 整 个 Java 项 目的 
开发 生命 周期 ， 如 图 9-1 所 示 。 图 9-1 的 左 侧 是 开发 人 员 个 人 计算 机 中 的 NWDS 开发 环境 ， 
即 开发 人 员 使 用 的 本 地 开发 工具 ， 右 侧 是 NWDI 的 开发 者 架构 (包含 了 DTR, CBS, CMS 等 
功能 ) ， 下 方 是 SAP NetWeaver 中 SLD 的 系统 目录 ， 这 些 专业 化 的 工具 保证 了 开发 人 员 在 
SAP 的 Java 开发 中 的 高 效 和 便捷 。 


本 地 开发 环境 (个 人 计算 机 ) NWDI 开发 者 架构 ( SAP NetWeaver 平 台 ) 


NWDS 开发 者 工作 室 A 


Component 


Build Service 
(CBS) 
I 


Run 
Time 


Design Time 
Repository Deploy J2EE 
(DTR) => Systems 
(RTS) 


Change Management Service 
(CMS) 


开发 组 件 E Ñ 3 | 


B Name Service 
本 地 文件 对 统帅 本 地 J2EE 引 擎 
System Landscape 
Directory (SLD) 


图 9-1 NWDI 架构 与 本 地 开发 环境 的 协作 
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9.1.1 设计 时 资源 库 


DTR 提供 了 一 个 对 所 有 源 代码 进行 集中 存储 、 管 理 以 及 版 本 控制 的 资源 库 ， 同 时 还 针 
对 所 有 的 开发 对 象 进行 自动 的 代码 冲突 检测 和 处 理 。 作 为 客户 端的 DTR 部 分 深度 集成 在 
SAP NetWeaver 开发 者 工作 室 (NWDS) 中 ,提供 了 对 所 有 可 用 项 目 类 型 的 支持 。 
对 于 大 规模 的 开发 项 目 ，DTR 提供 了 分 布 式 的 同步 开发 机 制 : 
© 不 同 的 开发 小 组 可 以 同步 进行 开发 工作 ， 即 使 不 同 开 发 人 员 分 布 在 不 同 的 工作 场所 甚 
至 不 同城 市 ， 他 们 也 可 以 通过 与 服务 端 DTR 的 连接 来 保证 所 有 的 修改 能 够 顺利 进行 。 
。DTR 会 自动 检测 同一 个 开发 对 象 是 否 会 产生 两 个 不 同 的 版 本 ， 并 在 修改 之 前 就 进行 提 
醒 ， 以 防止 源 代码 不 一 致 的 情况 出 现 。 
e 当代 码 冲 突 在 DTR 中 出 现时 ， 也 可 以 通过 DTR 进行 处 理 并 解决 冲突 ，DTR 可 以 提供 
开发 对 象 的 版 本 历史 、 不 同 版 本 的 代码 比较 以 及 用 户 处 理 的 推荐 选项 ,方便 不 同 开发 
人 员 处 理 不 同情 况 的 代码 冲突 。 
DTR 对 于 开发 对 象 的 文件 和 文件 日 录 管 理 提供 了 以 下 功能 : 
e 虽然 所 有 开发 对 象 都 是 存储 在 DTR 的 服务 右 端 ， 但 在 开发 人 员 本 地 开发 环境 中 ， 通 
过 SAP NetWeaver 开发 者 工作 室 登 录 NWDI 后 ， 就 能 方便 地 查看 所 有 相关 的 文件 和 目 
录 ， 并 根据 实际 需求 进行 检 出 和 修改 。 
© 源 代码 文件 会 根据 不 同 的 开发 语言 分 别 进 行 存储 ， 但 所 有 开发 对 象 的 文件 都 可 以 进行 
存储 管理 和 版 本 管理 。 
DTR 还 提供 了 “ 检 入 / 检 出 ”(Check In/Check Out) 模型 进行 开发 对 象 管理 : 
e 开发 人 员 要 修改 一 个 开发 对 象 ， 首 先 要 通过 “Checek Out” 检 出 动作 获取 最 新 版 本 的 
代码 文件 拷贝 ， 随 后 在 本 地 的 代码 文件 或 开发 对 象 中 进行 相关 修改 ， 在 完成 开发 后 ， 
通过 “Check mm” 检 和 人 动作 将 本 地 修改 的 开发 对 象 同步 至 服务 端 。 
© 而 每 次 开发 人 员 对 于 开发 对 象 的 修改 ， 都 会 产生 一 个 活动 (Activity) ， 在 活动 中 记录 
了 所 有 本 地 修改 的 开发 对 象 ， 以 及 开发 对 象 中 具体 修改 的 内 容 。 
对 于 开发 人 员 来 说 ，DTR 包含 了 客户 端 和 服务 端 ， 服 务 端 一 般 由 项 目 管理 员 或 开发 组 
长 进行 统一 配置 ， 可 以 通过 浏览 器 地 址 直接 进行 访问 : http:// <host > : < port >/devinf; 而 
客户 端 就 集成 在 SAP NetWeaver 开发 者 工作 室 中 ， 可 以 在 视图 选择 中 找到 对 应 的 “Design 
Time Repository” 视图 。 需 要 注意 的 是 ，DTR 不 仅仅 只 是 一 个 开发 对 象 的 共享 目录 ， 它 还 与 
CBS 和 CMS 等 NWDI 中 的 服务 紧密 集成 ， 共 同 为 SAP 的 Java 开发 人 员 提供 了 良好 的 开发 体 
验 。 如 果 需 访问 服务 需 端 DTR， 则 可 通过 浏览 锅 访 问 “http:// <host > : <port >/devint” Ff 
找到 DTR 的 对 应 链接 ， 如 图 9-2 所 示 。 


Design Time Repository (DTR) 


The DTR provides central file and folder based storage of source code, version histories and 
concurrent work on resources. It enables effective teamwork among developers distributed over 
different locations 


图 9-2 服务 器 端的 DTR 链接 


BEA DIR 后 ， 首 先 看 到 的 就 是 所 有 开发 对 象 的 资源 库 浏览 器 ， 如 图 9-3 所 示 。 
FELT RATA PA GRE “reports” RETA, SRX A TRIAS AY DI 活动 的 搜索 、 版 
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本 冲突 、 源 文件 路 径 、 源 文件 的 查询 以 及 工作 空间 的 对 比 与 整合 等 ， 如 图 9-4 所 示 。 


B Activity Search 
B Conflict Search 


- > 
Repository Browser 己 File/Folder Search 


N 
Resource Content Type — Resource Lookup 


/ 


= 
© VersionSet Comparison 


> X 
(9 system-tools ©) Workspace Comparison 
ws System 


X 
=| Workspace Integrations 


图 9-3 资源 库 浏览 图 9-4 查看 具体 开发 对 象 


在 展开 对 应 的 目录 后 ， 就 能 看 到 所 有 开发 项 目 在 DTR 中 存储 的 目录 结构 以 及 对 应 的 开 
发 对 象 ， 右 侧 还 提供 了 一 些 活动 处 理 按钮 对 开发 对 象 进行 简单 处 理 ， 如 图 9-5 所 示 。 


Resource Last Modified Actions 


J BPMD 


cn.com_BPMS x) +) 


图 9-5 不 同 目 录 以 及 处 理 界 卫 


9.1.2 组 件 编译 服务 


CBS 是 基于 J2EE 架构 的 服务 端的 数据 库 应 用 程序 ， 它 基于 组 件 模 型 架构 并 且 专 门 用 
于 编译 SAP 开发 组 件 。 它 既 可 以 用 于 开发 阶段 的 编译 工作 ， 也 可 以 用 于 最 终 代码 整合 时 
的 工具 ， 最 重要 的 是 ， 它 与 DTR 资源 库 紧密 集成 。 要 了 解 CBS 首先 要 知道 它 的 一 些 
特性 : 

© 存储 软件 组 件 不 同 开发 状态 的 编译 版 本 信息 。 

© 根据 开发 人 员 的 需求 可 以 对 代码 修改 进行 即时 的 编译 ， 由 于 客户 端 环 境 的 存在 ， 不 再 

像 过 去 那样 需要 将 代码 同步 至 一 个 完整 的 编译 环境 中 运行 ， 完 全 可 以 在 本 地 开发 工具 
中 编译 通过 以 后 直接 更 新 。 
© 上 自动 重 编译 开发 对 象 所 依赖 的 开发 组 件 ， 保 证 开发 人 员 在 检 出 代码 时 就 能 得 到 与 服务 
器 端 同步 的 相关 运行 环境 。 

o 提供 了 网 页 端 管理 页 面 ， 方 便 管理 员 进行 维护 和 监控 。 

。 人 允许 不 同 编译 请 求 同 步 执行 ， 提 升 了 整体 的 编译 效率 。 

当 CBS 和 DTR 放 在 一 起 时 ， 需 要 学 习 一 个 新 的 概念 “激活 ” (activation) 。 激 活 是 
开发 对 象 从 DTR 进行 检 入 以 后 的 一 步 额外 的 动作 ， 作 用 是 使 所 有 的 修改 生效 。 举 例 来 说 ， 
一 个 功能 模块 由 不 同 开发 人 员 同 时 进行 开发 修改 ， 当 完成 一 部 分 功能 时 还 无 法 顺序 运行 程 
序 ， 所 以 完成 工作 的 开发 人 员 需 要 先进 行 检 入 的 动作 ， 而 在 所 有 开发 修改 都 完成 并 成 功 检 入 
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后 , 才 需 要 将 所 有 的 修改 进行 启用 ， 也 就 是 “激活 ”动作 使 修改 生效 。 另 外 ， 激 活 的 过 程 
并 不 需要 额外 的 编译 。 

为 什么 在 了 解 “ 激 活 ” 时 需要 撒 带 上 之 前 介绍 的 DTR 呢 ? 这 是 因为 在 客户 端的 DTR 中 
包含 了 两 个 不 同 的 工作 空间 : 未 激活 工作 空间 ， 所 有 的 开发 对 象 修改 都 在 这 里 进行 ; 已 激活 
工作 空间 ， 这 里 所 有 的 源 代 码 都 可 以 被 安全 使 用 ， 因 为 它们 在 检 入 前 都 已 经 过 了 CBS 的 编 
译 验 证 。 其 中 ,已 激活 工作 空间 会 随时 与 CBS 的 编译 空间 中 的 可 用 档案 进行 同步 ， 以 保证 
开发 对 象 的 可 用 性 。 

CBS 的 编译 空间 位 于 CBS 服务 器 上 ， 每 个 服务 器 可 以 有 多 个 编译 空间 且 相 互 独立 ， 编 
译 空间 用 于 存放 软件 组 件 在 不 同 开 发 状态 的 编译 档案 ， 而 其 中 最 新 的 可 用 档案 会 与 DTR 中 
已 激活 工作 空间 的 开发 对 象 进行 同步 。 

与 DTR 类 似 ，CBS 也 同样 有 客户 端的 激活 视图 ， 已 集成 在 SAP NetWeaver 开发 者 工作 
室 中 ， 用 于 激活 已 成 功 检 入 的 开发 对 象 的 修改 内 容 。 当 然 激活 的 对 象 就 是 在 DTR 中 进行 修 
改 时 生成 的 活动 (Activity)。 男 外 ，CBS 还 包括 了 服务 器 端的 CBS 服务 器 ， 用 于 管理 和 监控 
CBS 的 编译 空间 。 如 果 需 访问 服务 器 端 CBS， 则 可 通过 浏览 器 访问 “http:// <host > : < port >/ 
devinf” 并 找到 CBS 的 对 应 链接 ， 如 图 9-6 所 示 。 


Component Build Service (CBS) 


The CBS builds components and their dependents on demand and provides ready-to-use libraries and 
deployables for developers and runtime systems. 


图 9-6 服务 器 端的 CBS 


1) 在 进入 CBS Kita, 首先 看 到 的 是 CBS 的 编译 空间 (buildspaces)， 如 图 9-7 
所 示 。 


Buildspaces 


View || Edit || Delete | | | Refresh 


T| > Name $ Queued Request $ Processing Request $ Failed Requests (Last Week) | $ Total DCs | $ Broken DC: 
P 
| | MPD BPMD C 0 0 0 1,535 


| | MPD BPMD D 0 1 0 1,535 


图 9-7 编译 空间 


2) 单 击 不 同 的 编译 空间 链接 ， 就 能 看 到 对 应 的 不 同 内 容 (Compartments ) ， 如 图 9-8 
所 示 。 


Compartments 


Buildspace: |MPD_BPMD_D hd Build... || Initialize || Open in New Window Refresh 


& $ Compartment $ SC Vendor $ SC Name $ Archives | $ Sources | $ Activation Possible 


T 


图 9-8 编译 空间 中 的 不 同 内 容 


3) 在 开发 组 件 页 签 中 ， 可 以 看 到 当前 空间 包含 的 所 有 软件 组 件 和 开发 组 件 ， 如 图 9-9 

所 示 。 
4) 可 以 通过 单 击 右 侧 的 “Pending Activities” 对 应 的 链接 ， 查 看 未 激活 的 活动 内 容 ， 如 
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图 9-10 所 示 。 


velop DTR Workspaces 

DC Filter: [All DCs ~| | Build Variant: ~| | [Refresh 

All Development Components 
T| $ DC Name ni $ DCVendor | Collisions | $ Compile State | $ Metadata | $ Cycle-Free | $ Used DCs | 
F 
门 j /my01 myproject.com View coco OOD OO [om] 
E pictbase/my02 wd myproject.com View coco OO OO OO 


BS 


9-9 查看 软件 组 件 和 开发 组 件 


$ DC Vendor Collisions | > Compile State | Š Metadata | > Cycle-Free | = Used DCs | Pending Activities 
myproject.com View coco oD oO oo View 
myproject.com View coco OO OO o0 


图 9-10 查看 活动 内 容 的 操作 界面 


5) 在 查看 活动 内 容 的 界面 ， 可 以 对 清单 和 开发 对 象 进行 模糊 查询 ， 如 图 9-11 所 示 。 


Activities 
Buildspace [MPD_BPMD_D | 
Compartment [cn.com_BPMS_1 ”| 
Simple Search | Advanced Search Activated Activities 
Owner ji | 
Max. No. of Hits * 1,000 | 
Development Component |myproject. comipjctibase/my02_wd | [Reset | 
Search Results 
Activate even if build fails 
| $ Name 


[| modify myo2_wa My02CompView by zhaox at date 1449 


图 9-11 查看 活动 内 容 的 界面 


6) 单 击 表 格 上 方 的 “Acetivate” 按 钮 即 可 通过 服务 器 端 CBS 激活 对 应 的 活动 ，CBS 中 
也 会 自动 生成 请 求 号 (与 NWDS 中 操作 的 效果 相同 ) ， 并 通过 弹出 的 请 求 窗口 查看 激活 请 求 
的 结果 ， 激 活 请 求 执行 成 功 ， 如 图 9-12 所 示 。 


Requests 

Buildspace |MPD_BPMD_D v| Buildspace-IndependentSearch 

Advanced Search | Open Requests } Completed (Unconfirmed) Requests 

RequestID | 13,270 £ 

Search 

-Search Results om m m 

Confirm || Cancel || Suspend || Resume 

| RequestID | Request State | Request Type | Owner | Confirmed | Request Log 

门 13,270 | SUCCEEDED ACTIVATE dev_zhaox v View 
图 9-12 ”查看 请 求 状态 
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9.1.3 变更 管理 服务 


在 NWDI 中 ， 完 整 的 开发 场景 是 由 一 个 或 多 个 CBS、DTR 服务 器 以 及 一 个 SLD 对 应 的 
命名 服务 需 组 成 的 ， 而 CMS 就 是 负责 整个 开发 场景 定义 以 及 管理 的 中 央 服 务 。 

CMS 主要 用 于 配置 开发 前 景 ， 并 且 控 制 所 有 开发 对 象 的 系统 传输 及 应 用 部 署 。 另 外 ， 
CMS 还 负责 对 CBS 创建 开发 对 象 的 归档 ， 导 出 对 应 4 
SCA 文件 并 进行 系统 间 版 本 传输 。CBS 按时 间 顺 序 | ee 
对 不 同 激活 动作 产生 不 同 的 归档 文件 ，CMS 保留 了 | oman oo 
历史 版 本 的 archive， 并 确保 了 非 开 发 级 别 的 运行 时 e EE E 
部 署 。 同 时 CMS 可 以 自动 对 开发 轨道 配置 以 及 软件 Tracks 


组 件 的 依赖 同步 地 进行 修改 。 
在 CMS 中 可 以 看 到 轨道 的 清单 (Track List), Aias CMS HRS Ea 


如 图 9-13 所 示 。 
另外 ， 也 可 以 查看 具体 的 运行 时 系统 和 明细 信息 ， 如 图 9-14 所 示 。 


Check-In Development I) Consolidation Assembly Approval System State 
Track "BPMT" - Import Queue for Development System UNLOCKED (Failed: 0 | Running: 0 | Waiting: 0) 


[ Import Check || Import || Details... || Delete... || Reset... | | [ Select All |[ Lock... || Restore... || Refresh More >> || Download to Excel... 


> Processed at (GMT) > Component > Label > Owner = Import Check State 


图 9-14 开发 组 件 的 操作 界面 

开发 实例 : 
1) 在 客户 端 NWDS 中 ， 打 开 “Transport View”， 就 可 以 对 修改 完成 的 动作 进行 释放 ， 
如 图 9-15 所 示 。 


EAP transport View 53 ,> [Component Properties |d] Open Activities - MPD_BP | | Activation View ~ MPD_BP 


ransport View - MPD_BPMD_D (CMS) Ov 


a 


E- Æ, mpp_prap_p 
El (RB, /BPMD/cn. com_BPMS/dev/active/ j 
日 R Waiting x 
nodi fy my02_wd My02CompView by zhaox at datel449 


图 9-15 查看 完成 的 动作 


2) 右 击 需要 释放 的 动作 ， 随 后 选择 “Release” 进 行 释放 ， 如 图 9-16 所 示 。 


日 ~ Wi, MFD_BPND_D 
日 (PR, /BPMD/cn. com_BPNS/ dev/ active/ 


白 R Waiting 
odi fy my 


View Activity Details 


Properties 


图 9-16 释放 动作 的 菜单 选择 


3) 在 弹出 的 对 话 框 中 输入 变更 请 求 的 描述 ， 确 认 动 作 选 择 无 误 后 ， 单 击 “Release ac- 
tivities” 按钮 即 可 开始 释放 ， 如 图 9-17 所 示 。 
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M Release for Transport =|} xj 
Change request caption: [modify my02_wd My02CompView by zhaox at datel- 


E-E] Selected Activities 
AS modify my02_wd MyO2CompView by zhaox at datel449 


Activity Details 


Description: I 


Elements: | 


Last Modified: I 


器 
[HI 


9-17 确认 对 话 和 


4) 释放 后 ， 在 传输 视图 中 可 以 看 到 对 应 的 内 容 清单 ， 如 图 9-18 所 示 。 


modify my02_wd MyO02Comp¥iew by zhaox at datel449 


AX modify my02_wd MyO2CompView by zhaox at datel449 


图 9-18 传输 内 容 


5) 接着 进入 服务 器 端的 CMS， 选 择 “Runtime Systems” —> “Consolidation” , 4E% 2 P 
就 能 看 到 刚才 释放 的 动作 ， 对 应 的 状态 是 “等 待 导入 ”， 如 图 9-19 所 示 。 


Checkin V Development = Consolidation Assembly | Approval System State | 


Track “BPMD" - Import Queue for Consolidation System UNLOCKED (Failed: 0 | Running: 0| Waiting: 4) 


Import Check || Import || Details... |[ Delete... || Reset... | | [ Select all |[ Lock... || Restore... || Refresh | | | More >> || Download to Excel... || Export SCA... || Deployment... | | [ Go to History 
© | $ Processed at (GMT) $ Component | Ê Label | => Owner = Import Check State | $ State 
F 
< 2014-01-11 07:17:18 cn.com_BPMS modify my02_wd My02CompView by zhaox ... dev_zhaox Not executed Waiting for import 
ae JE 
图 9-19 轨道 操作 界面 


6) 选中 该 行 后 ， 单 击 上 方 的 “Import” 按 钮 进行 时 入。 导入 成 功 后 状态 更 新 成 为 了 
“Import finished”， 如 图 9-20 所 示 。 


T| $ Processed at (GMT) $ Component | $ Label | $$ Owner | > Import Check State | $ State 
F 
2014-01-11 07:24:58 cn.com_BPMS modify my02_wd My02CompView by zhaox ... dev_zhaox Not executed Import finished 
图 9-20 查看 导入 状态 


7) 接着 进入 “Assembly” 页 签 ， 之 前 导入 的 动作 状态 变 成 了 “Waiting for assembly” , 
如 图 9-21 所 示 。 


Checkin | Development / Consolidation Assembly | Approval y System State 


Track "BPMD" - Component Versions for Assembly (Failed: 0 | Running: 0 | Waiting: 1) 
Assemble Component(s)... || Details... || Reset. | | [SelectAll || Refresh | | | Forward from History... || Attach from History... | | [ Download to Excel... || Export SCA... Go to History 


$ Processe $ Component $ Release s umber | 2 Patch Name | Patch Level > New > State 
= Pr d at (GM $C t > Rel = SP Numb | | 


¥ 
kee 2014-01-11 06:43:30 cn.com_BPMS 1.0 1 BPMD.01110642 1 1/0 Waiting for assembly 


图 9-21 轨道 操作 界面 


8) 选中 该 动作 ， 单 击 上 方 的 “Assemble Component(s) ”按钮 ， 在 弹出 的 对 话 框 中 设置 
对 应 的 属性 和 补丁 等 级 ， 单 击 “Assemble” 按钮 开始 集成 ， 如 图 9-22 所 示 。 
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Assembly Options 


Patch Name: | BPMD.01110725 
Assembly Mode 
(© Stop at First Inconsistent Component Handle as inconsistency 
© Skip Inconsistent Components [V] Broken DC [V Invalid or Missing SDA 
J) Dirty DC [V] Unresolved Repository Conflicts 


[v] Open Request 
[v] Pending Activity 


Include Modifiable Sources 


® Include Modifiable Sources in Archive 
Include Source Pointer in Arcl 


Support Package Number 
@ Keep Current Support Package Number 1 
Set Support Package Number to 2 
Patch Level 
Keep Current Patch Level 1 


Assemble Cancel 


N 
iza 


9-22 集成 对 话 


9) 在 集成 完毕 后 ， 就 可 以 单 击 “Export SCA” 按钮 ， 将 对 应 开发 对 象 进行 导出 ， 如 


图 9-23 所 示 。 


Track "BPMD" - Component Versions for Assembly (Failed: © | Running: 0| Waiting: 0) 


Assemble Components)... || Details... || Reset... | | [Select all || Refresh | | [ Forward from History... || Attach from History... | | [ Download to Excel... |f Export SCA Go to History 
W| $ Processed at (GMT) | $ Component Ê Release | 3 SP Number | $ Patch Name | Patch Level | > New = State 
F 
2014-01-11 07:32:01 cn.com_BPMS 1.0 1 BPMD.01110725 2 0/0 assembled 
sa p 
图 9-23 ”轨道 操作 界面 


10) 选择 相关 联 的 标准 软件 组 件 ， 单 击 “Create Archive(s)” 按 钮 ， 如 图 9-24 所 示 。 


Export Software Components from CMS 


Destination path where the created archives are to be exported 
Path is relative to/usr/sap/trans/EPS/in/CMSshmpdciMPD/CMSDownload 
C Destination Path 
Components of track BPMD 
ja Software Component Name Vendor | Release | Usage | Export 加 
BPMS cn.com 1.0 Developed 
BI-WDALV sap.com 7.30 Required = 
| BPEM-BASE sap.com 7.30 Required 
jail BPEM-BUILDT sap.com 7.30 Required 
BPEM-CONTENT sap.com 7.30 Required 
m| BPEM-CORE sap.com 7.30 Required 
| | BPEM-FACADE sap.com 7.30 Required 
| | BPEN-HIM sap.com 730 | Required 
| | BPEM-MM sap.com 7.30 Required 
| BRMS-BASE sap.com 7.30 Required 加 
Create Archive(s) Cancel = 


对 话 和 


IHI 


9-24 AJA 
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1) 归档 完成 后 ， 在 清单 中 就 能 看 到 下 载 的 链接 ， 单 击 “download” 即 可 开始 下 载 ， 如 


图 9-25 所 示 。 


Components oftrack BPMD 
Details 


全 Software Component Name Vendor Release Usage Export 
BPMS cn.com 1.0 Developed Download 


9-25 FRAM 


12) 使 用 本 地 的 SCA 文件 进行 导入 和 部 署 到 新 的 服务 器 端 ， 如 图 9-26 所 示 。 


9. 2 


=) 


SH Deployment Job: MPD £3 > olaa 


~ Deployment List (1 Items) 
List of items marked for deploym 


age en. cor Sa |_BPMD_C™: 20140111073159. s Import 


K| 9-26 通过 NWDS 进行 导入 


: 部 署 时 Settings 选择 只 更 新 低 版 本 DC. 


NWDI 初始 化 配置 


在 开始 使 用 NWDI 之 前 首先 要 确认 已 正确 安装 相关 组 件 ， 在 安装 SAP NetWeaver 时 也 必须 


“Vik 


NWDI 相关 的 内 容 条 目 。NWDI 的 初始 化 配置 有 两 种 方式 ， 在 NW 7.2 之 前 一 直 是 采用 手 


工 配置 的 方式 ， 但 由 于 手工 配置 步 又 繁 见 并 且 纠 错 能 力 较 低 ，NW 7. 2 之 后 推出 了 自动 配置 向 
导 执 行 。 这 里 介绍 通过 自动 向 导 进 行 配置 的 方式 ， 可 以 有 效 避 免 配置 过 程 中 出 现 遗 漏 。 


9. 2. 


1 CMS 配置 向 导 
自动 向 导 是 NWA 提供 的 一 个 集成 化 配置 工具 ， 通 过 浏览 器 地 址 直接 访问 ， http:// < 


host > ; < port > /devinf， 随 后 找到 “CMS Wizards” CMS 向 导 链 接 。 
1) 在 页 面 中 “CMS Wizards” 下 方 选 择 “Create an Application Skeleton”， 创 建 一 个 新 的 
用 框架 ,随即 进 入 具体 的 配置 向 导 中 ， 如 图 9-27 所 示 。 
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System Messages 


The System Messages page allows you to create messages that are displayed in the SAP 
NetWeaver Developer Studio upon log on to the Development Infrastructure 


CMS Wizards 


Create an Application Skeleton 

This wizard assists you with the creation of tracks for the development of some 
common application types, like for example JEE applications, Web Dynpros or 
Composite Applications 


N 


9-27 服务 器 端 CMS 向 导 


2) 填写 CMS 相应 的 基本 参数 和 连接 信息 ， 填 写 完成 后 单 击 “Next” 按 钮 ， 如 图 9-28 
所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton 


8% 


Step 3 of 24: Request Change Management Service 


Change Management Service 


Specify the Change Management Server you want to use for the creation of an application. Enter a valid user with administrative righty 


CMS URL: _ {http://.com:50100 ] 
User name: [ELSE 国 
Password: | ] 


|# Previous | Next B] Cancel 


图 9-28 配置 信息 


3) 创建 具体 的 轨道 ， 即 开发 架构 的 实例 ， 输 入 标识 和 描述 即 可 ， 如 图 9-29 所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton 


29% 
Step 8 of 24: Request information about Track and Software Component 


Development Track 


Specify the details of the track to be used for the creation of the application skeleton, or choose an 
existing track on the Change Management Server. 


[V] Create Track 


SNa ISMPD 


Track Id: 国 
Description: ] 


9-29 配置 轨道 


4) 随后 输入 默认 的 软件 组 件 的 名 称 、 供 应 商 和 版 本 号 ， 如 图 9-30 所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton 


29% 
Step 8 of 24: Request information about Track and Software Component 


Software Component 


Specify the name, vendor and version of the Software Component you want to modify in this track. 


Software Components 
Components Development with the NWDI 


Name: [BPMS 国 
Vendor: [cn.com 国 
Release: |1.0 


Application Template: [Composite Application 7.3 (with Business Process | ~ |A] 


Enhancement Pack: [9 oa 


[C] Attach Software Component to a Product 


图 9-30 输入 组 件 信 息 


5) 信息 确认 完毕 后 ， 向 导 将 自动 开始 创建 DI 轨道 、 软 件 组 件 以 及 往 CMS 导入 相关 目 
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录 和 归档 文件 的 动作 ， 并 且 接 下 来 的 过 程 不 需要 其 他 的 参数 输入 ， 用 户 可 以 从 CMS WebUI 
中 查看 执行 结果 并 做 执行 监控 ， 如 图 9-31 所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton 


[45% 
Step 12 of 24: Notify request input complete 


Confirmation 


The template now starts the creation of tracks, registering of new software components and the 
import of software component archives into the Change Management Server. 


The process runs unattended. No further input is required. 
Depending on the number and size of archives this process may take a considerable amount of time. 


You may monitor the progress and result in the CMS Transport Studio. 


Copy the following link to your browser and login with a suitable NWDI administrator user: 


9-31 ”自动 执行 过 程 


N 


6) 进入 CMS 监控 器 ， 可 以 看 到 向 导 自 动 新 建 的 轨道 实例 “BPMD”， 如 图 9-32 所 示 。 
7) 由 于 需要 导入 NWDI 相关 的 所 有 标准 包 (〈 即 软件 组 件 ) ， 因 此 向 导 会 在 最 后 一 步 导 
入 软件 组 件 包 时 运行 一 段 时 间 ， 需 要 耐心 等 待 ， 如 图 9-33 所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton | 


Generate Landscape Graphic 


Tracks 95% 
Refresh Step 24 of 24: Import Software Component Archives 
5 $ID Name | $ Description - SER) OS 
| lBPwD| BPMD  BPmD Details 
图 9-32 创建 完成 的 轨道 图 9-33 自动 执行 过 程 


8) 向 导 执 行 完 毕 ， 可 以 看 到 对 应 的 提示 消息 ， 如 图 9-34 所 示 。 


DI Change Management Service (CMS): Create an Application Skeleton 
100% 


Yy Finished "DI Change Management Service (CMS): Create an Application Skeleton” 


View Log Return to Task List 


Details 


图 9-34 ”执行 成 功 后 的 提示 消息 


9.2.2 SLD 命名 保留 

在 创建 DI 轨道 之 后 ， 还 需要 通过 SLD 命名 保留 ， 建 立 软 件 组 件 (SC) 的 供 方 名 称 和 开 
RACE (DC) 的 默认 命名 前 级 。 通 过 创建 的 SC 与 DC 的 命名 前 弘 ， 规 范 地 定义 了 DTR 中 
的 路 径 名 ， 方 便 后 期 的 开发 对 象 管 理 和 维护 。 


配置 实例 : 
1) 通过 浏览 器 地 址 直接 访问 : http:// < host > : < port >/sld, Aa; “Name Reservation” 


进入 详细 配置 界面 ， 如 图 9-35 所 示 。 
2) 选中 “Name Prefixes” 页 签 ， 在 “SC Name” 中 选择 “New Name Prefix”， 创 建 一 个 


新 的 命名 前 级 ， 在 弹出 的 对 话 框 中 输入 相关 必要 信息 ,保存 所 有 配置 ， 如 图 9-36 所 示 。 
3) 保存 修改 后 ， 就 可 以 在 表格 中 查看 已 创建 的 SC 命名 前 级 了 ， 如 图 9-37 所 示 。 
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Define a new name prefix for name reservations on this server 
Quantity: © Single © Bundle 国 
Name Category: * [Software Component Name ~ | (F) 
Development Name Prefix: * Mmyproject.com 国 
Name Reservation Purpose: * Used by developer i 
EL Manage Name Reservations for NetWeaver Development Owner: [devzhaox |] 国 
— Description 国 
CIM instances / CIM Classes 
A View and maintain data on CIM level 
图 9-35 服务 器 端 命名 保留 链接 图 9-36 输入 详细 信息 


Name Category: {Software Component Name (2) | Filter by Name: [ 


New Name Prefix Remove || Refresh 


‘if Name Prefix 


图 9-37 创建 前 级 名 操作 界面 


4) 将 “Name Category” 切 换 到 开发 组 件 名 称 ， 并 创建 一 个 命名 前 级 ， 输 入 必要 信息 并 
保存 ， 如 图 9-38 所 示 。 


Define a new name prefix for name reservations on this server 


Quantity: © Single © Bundle 国 
Name Category: * [Development Component Name ~ | [到 
Name Prefix: * [myproject.com/pjcd 国 
Purpose: * Used by developer X 国 
Owner: dev_zhaox _ 国 
Description: 国 


图 9-38 ”输入 详细 信息 


5) 保存 修改 后 ， 就 可 以 在 表格 中 查看 已 创建 的 DC 命名 前 级 了 ， 如 图 9-39 所 示 。 


” Name Prefixes | Names | 


Name Category: |Development Component Name (2) -| Filter by Name: | Go 


New Name Prefix... | Remove || Refresh 


局 Name Prefix 


图 9-39 查看 已 创建 的 命名 前 组 


9.3 NWDI 开发 应 用 实例 


以 NWDI 为 基础 的 Web Dynpro 开发 包含 下 列 步 又 。 

1) 通过 NWDS 中 的 配置 修改 ， 导 入 开发 配置 。 

2) 创建 开发 组 件 ， 不 仅 限 于 Web Dynpro 项 日 ， 也 包括 其 他 NetWeaver 支持 的 项 日 
类 型 。 

3) 完成 开发 和 修改 后 ， 对 开发 内 容 进 行 检 入 和 激活 。 

4) 处 理 在 代码 同步 过 程 中 出 现 的 错误 。 
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9.3.1 导 人 开发 配置 


1) 首先 需要 在 开发 工具 NWDS 中 导入 开发 环境 的 配置 。 在 导 和 人 之前， 只 有 指定 SLD 的 
目录 链接 ， 才 能 根据 SLD 中 对 应 的 命名 保留 进行 导入 。 打 开 NWDS 后 ， 选 择 “Window” 一 
“Preferences”， 如 图 9-40 所 示 。 


Help 
New Window 
New Editor 


Open Perspective > 


Show View » 


Customize Perspective... 
Save Perspective As... 
Reset Perspective... 
Close Perspective 


Close All Perspectives 


Navigation > 


Preferences 


图 9-40 NWDS 配置 的 菜单 选择 


2) 在 弹出 的 偏好 设置 对 话 框 中 找到 “Development Infrustrucure” — “System Landscape 
Directory”， 也 可 在 右上 方 输入 关键 字 进 行 模糊 搜索 并 定位 ， 选 择 该 配置 后 ， 在 对 话 框 右 侧 
的 URL 栏 中 输入 对 应 链接 “http://local host:50100”， 单 击 右 侧 的 “Ping” 按 钮 测试 是 否 连 
接 成 功 。 确 认 链 接 填 写 无 误 后 ， 单 击 “OK” 按 钮 ， 如 图 9-41 所 示 。 


[system System Landscape Directory 4 ee 
Development Infrastructure 


system Landscape Directory Specify the system landscape directory server for importing development configurations 
SAP AS Java URL http://localhost:50100 Ping 


Load certificate for secure connection to NWDI server 


Load Certificate | | Clear Certificate 


图 9-41 配置 SLD 的 对 话 框 


3) 接着 切换 到 “Development Infrastructure”， 在 空白 处 右 击 鼠 标 ， 选 择 “New” 一 
“Development Configuration”， 新 建 一 个 开发 配置 ， 如 图 9-42 所 示 。 


New +| Software Component... 


Show In >| Gy Development Configuration... 


图 9-42 创建 开发 配置 的 菜单 选择 


4) 在 弹出 的 对 话 框 中 选择 第 一 项 “Import from System Landscape Directory(SLD)”， 从 
已 配置 的 SLD 中 导入 开发 轨道 ， 随 后 单 击 “Next” 按 钮 ， 如 图 9-43 所 示 。 

5) 对 话 框 中 会 列 出 所 配置 SLD 中 所 有 可 用 的 轨道 ， 选 择 “BPMD_dev” 之 后 ， 所 有 的 
开发 都 会 在 该 轨道 中 的 软件 组 件 中 进行 ， 如 图 9-44 所 示 。 该 软件 组 件 的 包 名 已 预定 义 好 为 
“myproject. com”( 即 开发 人 员 在 该 软件 组 件 下 建立 的 开发 组 件 会 存储 在 目录 为 “com. myproject” 
的 文件 夹 中 ) 。 
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6) 随后 按 默认 配置 完成 导入 向 导 ， 对 应 的 轨道 就 会 出 现在 NWDS 中 的 浏览 选项 卡 中 ， 
如 图 9-45 所 示 。 


Create or Import Development Configuration j -10l x| 


Select an option from the list 
Development configurations can be created or imported here 


了 tory 
B Inport fro arr 
@ByCreate from Scratch 


Bs} 


9-43 ”选择 导入 选项 


——— 1 = 
Type text to filter (*=any string, ?=any character) 2} Component Browser 3 5. Navigator | 口 
"al > => F 

ne en eh | 
By BPMD_cons BPMD_cons gS. BPMD_dev [1] 
BPND_dev @ LocalDevelopment 


图 9-44 ”选择 对 应 轨道 图 9-45 导入 后 效果 


9.3.2 创建 开发 组 件 


1) 展开 “BPMD_dev” 轨 道 ， 一 般 在 开发 工具 与 服务 器 版 本 一 致 的 情况 下 ,会 看 到 与 
“LocalDevelopment” 一 致 的 日 录 结 构 。 找 到 自 定义 创建 的 “BPMS” 软 件 组 件 并 右 击 ， 选 择 
“New” — “Development Component”， 创 建 一 个 新 的 DC， 在 弹出 对 话 框 中 选择 要 新 建 的 DC 
的 类 型 ， 随 后 单 击 “Next” 按 钮 ， 如 图 9-46 所 示 。 

2) 严格 按照 项 目 组 命名 规范 ， 输 入 DC 的 名 称 以 及 标题 等 信息 。 建 议 选 中 “Keep DC Lo- 
cal for Now” 复 选 框 ， 暂 时 将 开发 组 件 保 留 在 本 地 选项 。 由 于 新 创建 的 开发 组 件 修 改 比 较 频 繁 ， 
因此 在 单个 开发 人 员 负 责 开发 的 情况 下 ,没有 必要 每 次 新 建 Java 文件 或 开发 对 象 都 进行 创建 
活动 并 与 DTR 进行 同步 ， 等 完成 初步 开发 后 ， 再 一 并 手动 进行 提交 ， 如 图 9-47 所 示 。 


& Composite Application 
B Content 
DC Build 

@ Dictionary 
ar Enterprise Portal 


= f Vendor: fa 
É External Library 


E Java Name: 


H- Java EE Caption: [haseyny0l_wd 


Process Composer 


Language: American English + 


Ry Rules Composer 

3 Service Composer Domain: [Basis =| 

S Service Group Configuration Support Component: | hasi 
yy Software Logistics (For Example BC-D¥B-FOO) 

pi Text 

E| Visual Composer 


Web Dynpro 


图 9-46 选择 项 目 类 型 图 9-47 输入 项 目 信 息 


3) 随后 根据 默认 配置 完成 创建 ， 即 可 在 本 地 进行 编码 、 编 译 、 部 署 以 及 测试 等 工作 。 
忽略 具体 的 开发 过 程 (可 参考 之 前 Web Dynpro 开发 介绍 的 章节 ) ， 在 完成 第 一 个 版 本 的 开 
发 后 ， 需 要 将 源 代码 同步 至 DTR 进行 保存 ， 右 击 对 应 的 DC， 并 选择 “Add to Source Con- 
trol”， 如 图 9-48 所 示 。 
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4) 在 首次 同步 时 ，DTR 服务 器 监测 到 了 开发 对 象 修改 ， 所 以 需要 创建 对 应 的 活动 。 在 
弹出 建立 活动 的 对 话 框 中 输入 必要 的 活动 名 称 以 及 具体 的 描述 ， 用 于 标识 该 活动 的 修改 目的 
及 相关 简要 信息 ， 随 后 单 击 “OK” 按 钮 ， 如 图 9-49 所 示 。 


n] 


力图- 转 - 转 :图 - 轩 -力图 -力图 : 力 :图 - 转 : 轩 - 力 -图 - 


E 


MA BPWS [en con] EF 

H Da BR er » 

BS BRIS-BASE Show In » 

上 BRNS-BUIL - 

ae BRNS-CORE Sync / Create Project 上 

Qe BRMS-FACA g9 Build AlttShi ft+B (tier Ne 
RE CAF (sap. Deploy... ALtHShi ftty 加 ms 
Qe CAF-MF [s JÉ Delete 

BË cOMP_BUIL: 

ge cu-pase-y, Move... 


ge cu-pase-#: ob Cut 
上 DaTa-mapp: = Copy 
BË ECN-CORE 


Paste 


BE ENGFACADE TC Stat 
EË ENGINEAPI ed 
Qe EP-ADNIN 


Qe EP-BASIS 


Central Deployment Log 


BS EF-BASIS-. 4 Search for IC... 
上 EP-CONNEC’ ， Refresh 


9. 3. 


图 9-48 同步 DTR 的 菜单 选择 


图 9-49 创建 活动 对 话 框 


HI 


5) EAEI Sha, m AREA TR 3) 中 的 添加 动作 。 选 择 刚才 创建 的 活动 ， 单 击 
“OK” 按 钮 完成 开发 对 象 的 添加 ， 如 图 9-50 所 示 。 


nyl wd add to sou 


urce by zhaox 


Available activities under workspace ‘inactive’ 


at date/time 


zj 


9-50 查看 创建 的 活动 


6) 接着 在 对 应 的 视图 中 展开 活动 ， 就 能 看 到 所 有 已 修改 的 开发 对 象 ， 包括 源 代码 的 文 
件 夹 、 配 置 文件 、 源 代码 文件 等 内 容 ， 如 图 9-51 所 示 。 


日 ~ E, MPD_BPMD_D 


haox at date/time 
pict/base/my01_wd/_comp 


. . #DCs/myproject. com/pjct/base/my01_wd/_comp/. dedef 

... /DCs/myproject. com/pjct/base/my01_wd/_comp/cfg 

... fDCs/myproject. com/pjct/base/my01_wd/_comp/def 

... fDCs/myproject. com/pjct/base/my01_wd/_comp/sre 

... fDCs/myproject. com/pjct/base/my01_wd/_comp/test 

... fDCs/myproject. com/pjct/base/my01_wd/_comp/WEB-INF 

... /DCs/myproject. com/pjct/base/my01_wd/_comp/WEB-INF/web. xml 


#SCs/en. com/BPMS/_comp/TopLevelDCs 


... #SCsfen. com/BPMS/_comp/TopLevelDCs/myproject. com pjct base my01_wd. deref 


3 检 人 与 激活 


9-51 在 活动 中 添加 开发 对 象 


1) 在 确认 编译 无 误 ， 可 以 上 传 至 DTR 进行 编译 后 ， 首 先进 入 “Open Activities” 的 视 
图 ， 找 到 对 应 的 活动 ， 右 击 鼠 标 并 选择 “Checkin” 进行 栓 入， 如 图 9-52 所 示 。 

2) 在 弹出 的 对 话 框 中 需要 确认 所 选 活动 是 否 正 确 、 包 含 的 开发 对 象 是 否 正 确 ， 确 认 无 
误 后 单 击 “OK” 按 钮 ， 如 图 9-53 所 示 。 
394 


[Se Activity Check-In x| 


Description |ny01_wd add to source by zhaox at date/time 


E 


Edit 
Use as Default 


lei Ea 


Elements | ... fDCs/myproject. com/pjet/base/my01_wd/_comp/WEB-INF 
| .../DCsfmyproject. com/pjet/base/ny0l_wd/_conp/ def 


“) ... /DCs/myproject. com/pjct/base/my01_wd/_comp/cfg 


Revert 


Revert Unchanged Items 


heise ... /SCs/en. com/BPMS/_comp/TopLevelDCs = 
t Upload =)... fDCs/myproject. com/pjct/base/my01_wd/_comp/WEB-INF/web. xml 

Forced Upload ... fICsfmyproject. com/pjct/base/my01_wd/_comp/. dcdef = 
4 Download — —— => 


Forced Download 


Properties 


器 
TFA] 


9-52 ” 检 入 的 菜单 选择 图 9-53 ”导入 内 容 确 认 对 话机 

3) 检 入 成 功 后 ， 会 有 对 话 框 提示 是 否 自 动 将 修改 内 容 进行 激活 。 如 果 有 多 个 开发 人 员 
协同 开发 时 ,请 韦 慎 选择 自动 激活 选项 。 在 本 实例 中 ， 单 击 “Yes” 按 钮 直接 激活 修改 ， 如 
图 9-54 所 示 。 


activation x 
© Start activation now? 


9-54 ”自动 激活 确认 对 话 框 
注 : 如 果 未 弹出 是 否 激 活 的 提示 对 话 框 窗口 ， 则 可 以 通过 偏好 设置 中 的 “Development 
Infrastructure” 修改 具体 的 开发 工具 配置 。 
4) 在 弹出 的 激活 对 应 活动 的 确认 对 话 框 中 ,确认 无 误 后 ， 单 击 “Activate” 按 钮 进行 激 
活 ， 如 图 9-55 所 示 。 
=o x) 


G) No predecessor activity detected 


Predecessors Check 


EE] Selected Activity 
=] A my0l_wd add to source by zhaox at date/time 


[ Calculate predecessor activities based on overlapping files only |(?) 


Activity Details 


Description [my01_wd add to source by zhaox at date/time = 


LETS (a... /DCs/myproject. con/pjet/base/my01_wa/_comp 
Uy... /DCs/myproject. com/pjct/base/my01_wd/_comp/. dedef 
iva... /DCs/myproject. com/pjct/base/my01_wd/_comp/efg 

ia... /DCs/myproject. com/pjct/base/my01_wd/_comp/def 了 | 


Last Modified |January 9, 2014 7:54:06 AM GMT by dev_zhaox 


Activate Cancel | Advanced >> 


器 


9-55 ”激活 操作 对 话 框 
5) 在 CBS 中 会 自动 生成 一 个 新 的 激活 请 求 ID ， 可 以 通过 激活 请 求 的 视图 查看 具体 的 请 
求 修改 状态 ， 单 击 “Open Request View” 直 接 跳 转 至 对 应 视图 ， 如 图 9-56 所 示 。 
6) 在 视图 中 可 以 单 击 刷 新 按钮 ， 刷 新 请 求 的 最 新 状态 ， 在 对 应 的 请 求 号 右 侧 出 现 绿色 
对 色 后 ， 标 识 该 激活 请 求 已 成 功 完成 ， 如 图 9-57 所 示 。 


H 
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Activation Request 3 x! 


(i) Your activation request has been accepted by CBS 
| | 


Activation Request ID |13252 


图 9-56 EPR MTA 


HI 


S] Activation Req £3 > [C] Infrastructure |e Progress View| "| Properties | © | Error Log| 5 9 
lActivation Requests - MPD_BPMD_D 
Request ID 入 À Request Activities 5% Activation Results 
E: fo 
= ERÉ cn. com BPMS_1 
Jr Ep 
图 9-57 ”查看 激活 状态 


如 果 激 活 失 败 ， 则 单 击 “View Activation Log” 按钮 ， 查 看 激活 操作 日 志 或 者 查看 CBS 编 
译 日 志 ， 并 分 析 失 败 产 生 的 原因 。 代 码 提交 产生 的 问题 应 及 时 改正 并 重新 激活 ， 直 至 激活 成 
功 ; 其 他 依赖 DC 造成 的 激活 失败 ， 应 联系 NWD 管理 员 和 相关 开发 人 员 解 决 。 

7) 激活 成 功 后 ， 才 可 以 将 对 应 的 活动 进行 传输 。 首 先进 入 传输 视图 中 ， 找 到 已 成 功 激 
活 的 活动 ， 如 图 9-58 所 示 。 

8) 右 击 对 应 的 活动 ， 并 选择 “Release” 释 放 该 活动 ， 如 图 9-59 所 示 。 这 与 ABAP JF 
发 中 激活 成 功 后 ， 需 要 进行 释放 请 求 的 操作 非常 相似 。 


ransport View - MPD_BPMD_D (CMS) 
Gh E, MPD_BPMD_D, 
E- GB, /BPMD/ cn. com_BPMS/dev/ actives ie - 
B- A taiting re X Show Export Log 
H AX myOt_wd add to source by zhaox at date/time View Activity Details 
H- (AP Released 


Properties 


图 9-58 ”查看 传输 视图 图 9-59 释放 操作 的 菜单 选择 


9) 在 弹出 的 对 话 框 中 确认 需要 释放 的 活动 的 信息 是 否 正确 ， 随 后 单 击 “Release activi- 
ties” 按钮 进行 释放 操作 ， 如 图 9-60 所 示 。 
10) 释放 的 活动 将 通过 CMS 的 传输 管理 进行 后 续 的 系统 间 对 象 传输 动作 ， 如 图 9-61 所 示 。 


[WRelease for Transport 10) x! 


Change request caption: |ny01_wd add to source by zhaox at date/time 


Activity Details 
Description: 


... fDCs/myproject. com/pjct/base/my01_wd/_comps 
pjct/base/my01_wd/_compy. 
\/pjct/base/my01_wd/_compy 


pjct/base/my01_wd/_compy > 
fA DEANE ,可 


Elements: 


E- @@, /BPMD/cn. com_BPMS/dev/ actives 
日- 入 Released Pes 
El @ myOl_wd add to source by zhaox at date/time 


i A myOl_wd add to source by zhaox at date/time 
cane 


出 


图 9-60 释放 操作 对 话 框 图 9-61 查看 传输 对 象 
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9.3.4 协同 开发 场景 


下 面 介 绍 在 多 个 开发 人 员 协 同 开 发 时 的 一 些 具 体 开 发 步骤 。 

开发 实例 : 

1) 准备 两 个 工作 空间 以 及 两 个 具备 “NWDI. DEVELOPER” 权 限 的 用 户 ， 首 先 使 用 其 
中 一 个 用 户 登 录 NWDI， 并 创建 一 个 Web Dynpro 类 型 的 DC 工程 ， 如 图 9-62 所 示 。 

2) Æ Web Dynpro 项 目 中 创建 对 应 的 组 件 和 视图 ， 如 图 9-63 所 示 。 

3) 在 视图 中 添加 一 个 按钮 元 素 ， 并 绑 定 “Query” 自 定义 动作 ， 如 图 9-64 所 示 。 


日 -区 MyO2Comp 
EÈ Component Controller 
由 - 国 Local Component Interface 
$< Custom Controllers 
@ Implemented Interfaces 
[E] message Pool 
@y Used Models 
<i Used Components 
EME Views 
ty02C ompi ew 
H- Windows 


图 9-63 创建 对 应 的 组 件 和 视图 K 


E- 
由 一 ya pjet/base/my0l_wd [myproject. com] 
由 fa pict/base/my02_wd [myproject. com] | 


图 9-62 创建 新 开发 组 件 
4) 根据 之 前 的 操作 介绍 ， 将 该 Web Dynpro 项 目的 所 有 内 容 检 入 至 DTR 目录 中 ， 随 后 


登录 DTR 并 定位 到 该 Web Dynpro 项 目 目录 中 的 视 岁 控制 器 文件 ， 单 击 最 右 侧 的 “下 载 ” 按 
钮 并 查看 文件 内 容 ， 如 图 9-65 所 示 。 


Button 


9-64 创建 按钮 


CI myo2comp Hares 
站 dev zhaox 。 applicationxml 2179 11.01.201406:26:45 GMT — 11.01.2014 06:3251GMT DANA EY BS 
E) myo2comp.wdcontrolter dev_zhaox 。 applicationxml 718 + 11.01.201406:26:45GMT 11.01.2014 06:3251GMT DANA RS 
加 dev_zhaox applicationxmi 760 11.01.2014 06:26:45GMT —11.01.201406:3251GMT HANA QS 
E) myo2compintertace.walocalcompintidet dev_zhaox «= applicationxml 41374 11.01.2014 06:26:45GMT ”11.01.201406:32.51GMT DANA EY BS 
B Myo2CompinterfaceView.wdcontroller dev zhaox applicationxml 927 11.01.2014 06:26:45 GMT 11.01.2014 06:32:51 GMT Aa wx ys 
B My02CompinterfaceView.wdinterfaceview dev_zhaox applicationxml 934 11.01.2014 06:26:45 GMT 11.01.2014 06:32:51 GMT 一 EHA wx RTI 
E dev_zhaox applicationxmi 588 11.01.2014 06:26:45GMT 11.01.201406:3251GMT HAS QS 
B E dev zhaox applicationxmi 1202 12.01.2014 07:09:43GMT 12.01.2014 07:10:15GMT > AAS) ae ) 
E) myo2compview.waview dev_zhaox applicationxml 2619 12.01.201407:09:43GMT ”1201.201407:10:15GMT DANA EY BS 


9-65 


查看 DTR 明细 
5) 文件 内 容 中 含有 新 建 的 名 称 为 “Query” 的 按钮 动作 ， 如 图 9-66 所 示 。 


</Action> 


F <Controler. Actions 
- <Action name="Query"> 
- <IncomingEvent.EventHandler> 
<Core.Reference path="EventHandler:onActionQuery" /> 
</IncomingEvent.EventHandler> 


</Controller.Actions> 


9-66 查看 按钮 动作 定义 


6) Æ DTR 上 该 文件 的 上 次 修改 时 间 ， 即 活动 的 检 入 时 间 可 以 通过 激活 明细 进行 查看 。 
另外 ,还 可 以 查看 不 同 开发 阶段 检 入 的 历史 版 本 。 
7) 接着 回 到 NWDS 开发 工具 中 ， 切换 至 “Development Infrastructure” 视图， 在 文件 浏 
览 中 找到 “srec” 目录 中 的 视图 控制 器 开发 对 象 文 件 ， 如 图 9-67 所 示 。 
8) 右 击 该 文件 ， 并 选择 “Team” 一 “Show In” — “Version Graph”， 显 示 历 史 版 本 ， 


如 图 9-68 所 示 。 


9) 接着 就 可 以 查看 对 应 文件 的 的 DTR 检 入 版 本 ， 如 图 9-69 所 示 。 注 意 ， 这 里 的 不 同 
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Co NETA-INF 

El E sre 
[cm configuration 
Coe mimes 
Ge Q packages 


Ek E com 
È- By myproject 
B- © pict 
È- p base 
Be E my02_wd 
Š- pg wd 
È- 思 comp 


A E my0zcomp 

S My02Comp. wdcomponent 
My02Comp. wdeontroller 
My02CompInter face. wdcontroller 
My02CompInter face. wdlocalcompintfdef 
My02CompInter faceView. wdcontroller 
My02CompInter faceView. wdinterfacevied 


thy 


[D DD GD GD GD MD Hp Gp i 


ompllessagePool. wdmessagepool 
Vi ew ller 
NyO2CompVi ew. wdvi ew 


图 9-67 浏览 开发 对 象 目录 


Repository Browser 


Advanced Sync eee 
3 vision History 
= Remove from Client 


a Package Explorer 

dp Add 

Etait __ Resource Navigator 
Edit (Exclusive) Explorer (External) 

$ Delete 


Locking 


Revert 


Resolve Conflict » 


OS View Content 


Vi anges 

lcomp 
EI myf2comp 

B my02con— 

ERE ; 

[E Mlyo2con Show In » 

E My02Con Search for DC... 

L] My02Con C Refresh Forced Download 

国 my02Con 


国 Properties 


图 9-68 显示 历史 版 本 的 菜单 选择 


版 本 并 不 是 CBS 的 激活 历史 ， 而 是 “Checkin” 检 和 人 的 历史 版 本 。 

10) 图 9-69 中 每 一 个 结 点 代表 一 次 检 和 人 操作 ， 右 击 每 一 个 结 点 可 以 查看 具体 检 和 活动 
的 明细 内 容 ， 包 含 该 版 本 下 的 文件 内 容 、 该 版 本 与 上 一 版 本 的 内 容 差异 、 该 版 本 与 DTR 最 
新 版 本 的 内 容 差 异 和 同步 为 对 应 版 本 等 内 容 ， 如 图 9-70 所 示 。 


ee-|R-* 


BPMD. .. 


Show In A 


View Activity Details 
GS View Content 
A View Changes 


Compare with Active Version 


Compare Versions 


< Sync to this Version 


Selected Workspace ’ /dtr/ws/BPMD/ cn. com_BPMS/dev/inactive/” | 


Properties 


图 9-69 DTR 中 的 版 本 记录 9-70” 检 入 相关 的 菜单 选择 
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11) ZEAE MRCP Ze, AAA Pia AY CHE, EE “Team” — “Show In” — 
“Revision History”。 该 视图 是 对 “Version Graph” 版 本 图 形 的 列表 显示 ， 显 示 了 未 激活 工作 
空间 中 的 激活 历史 ， 行 项 目的 具体 内 容 与 版 本 图 形 中 的 结 点 一 致 ， 如 图 9-71 所 示 。 


Tes Revisi i F 
= Revision History E 


Revision history of resource 
fdtr/ws/BPMD/ cn, com_BPMS/dev/inactive/ 


Workspace 


/DCs/nyproject. com/pjct/base/my02_wd/_comp/sre/p. 
... fDCs/myproject. com/pjct/base/my02_wd/_comp/sre/p... J. 
/DCs/myproject. com/pjct/base/my02_wd/_comp/sre/p... J... 


BN 


BN 


Activity Details 


Display name [modify view by zhaox at date1509 
Description 一 


J dev_rhaox 


-IIx 


.ADCs/myproject. com/pjct/base/my02_wd/_comp/src/packages/com/myproject/pjct/base/my02_wd/waf comp/my02comp/My02CompVi ew. wdcontroller 


Edit 
Edit 


dev_zhaox Branch Seq No 


Branch Seq No. 


2 in workspace: 22 


dev_zhaox 1 in workspace: ... 21 


Close 


图 9-71 


显示 恢复 历史 


12) 接着 切换 到 另外 一 个 NWDS 的 开发 空间 ， 并 且 使 用 不 同 的 账号 登录 NWDI， 用 于 模 
拟 另 一 个 开发 人 员 需 要 进行 协同 开发 的 场景 。 在 打开 NWDS 并 登录 同一 个 NWDI 后 ， 找 到 
之 前 自 定义 配置 的 “BPMS” 软 件 组 件 ， 以 及 在 之 前 步 又 中 创建 的 Web Dynpro 项 目 ， 右 击 该 
项 目 并 选择 “Sync/Create Project” 一 “Create Project”， 将 DTR 中 的 项 目 复制 创建 至 本 地 的 


工作 空间 中 ， 如 图 9-72 所 示 。 


E- BY BMS [en com] 
H- GP pjct/base/myO1_wd [myproject. com] 

ae @ 

GË BRMS-BASE [sap. com] 
GË BRMS-BUILDT [sap. co 
BË BRMS-CORE [sap. com] 
BË PRNS-FACADE [sap. co x 
BË CAF [sap. com] i 
BË CAF-MF [sap. com] 
RË COMP BUILDT [sap co Syne Archives 


9-72 ”同步 项 目的 菜单 选择 
13) 接着 进入 对 应 的 Web Dynpro 视图 ， 找 到 之 前 创建 的 视图 ， 如 图 9-73 所 示 。 


日 - 喝 Wy02Comp 

EÈ Component Controller 

由 Local Component Interface 
Í< Custom Controllers 
@® Implemented Interfaces 
[E] Message Pool 

-Used Models 
«Gj Used Components 

EE Views 

= 


New 
Show In » 


AlttShi £tt+B 


3 Sync Inactive Sources... 
AlttShi fttY 


Syne Active Sources 


ee 


HyO2C ompVi ew 


at 
H- Yindows 


图 9-73 同步 后 的 目录 结构 


14) 当 再 次 编辑 该 视图 时 ， 在 按钮 的 事件 处 理 右 中 添加 下 列 代码 . 


publicvoid onActionQuery ( com. sap. tc. webdynpro. progmodel. api. IWDCustomEvent wdEvent) 
| 

//@ @ begin onActionQuery( ServerEvent ) 
wdComponentAPI. getMessageManager( ). reportSuccess( "执行 成 功 1" ) ; 

//@ @ end 
| 
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15) 完成 修改 后 ， 单 击 “保存 ”按钮 ， 将 自动 弹出 “Checkout” 对 话 框 ， 因 为 DTR 已 
监测 到 当前 的 开发 正在 进行 一 个 新 的 开发 修改 ， 单 击 “Check Out” 按 钮 即 可 开始 修改 ， 如 
图 9-74 所 示 。 


Checkout Required 


(i) The operation requires the following objects to be writeable: 


View com. Cerai pjct. base. my02_wd. wd. comp. my02com 
Read-oi 


ip. My02C om 
D:\n730_wk_nbk01. DD Nyre a it, na wd\_comp\sre\packages\com\myproject\pjct\base\my02_wdiwd 
\comp\myO2comp TD ew. wdview. xlf 
Read-only: D:\nT30_wk_nbk01. jdi\O\DCs\myproject. com\pjct\base\my02_wd\_comp\sre\packages\com\myproject\pjct\base\my02_wd\wd 
\comp \my2 comp \My02C omp¥i ew. wdcontroller 
Read-only: D:\n730_wk_nbkO1. jdi\O\DCs\myproject. com\pjct\base\my02_wd\_comp\src\packages\com\myproject\pjct\base\my02_wd\wd 
\comp \my(2 comp \My02C ompVi ew. wdvi ew 


L 
Check Out Cancel 


HI 


9-74 ” 检 出 确认 对 话 框 


16) 接着 选择 需要 包含 修改 内 容 的 动作 ， 如 没有 修改 中 的 活动 ， 则 可 以 单 击 “New” 创 
建 一 个 新 的 活动 来 包含 将 要 进行 的 开发 修改 内 容 ， 如 图 9-75 所 示 。 


[ESelect Activity 


Available activities under workspace ’ inactive’ 


Description of Activity 


[ Use as default activity for this DTR workspace 


图 9-75 ”新建 活动 


17) 在 弹出 的 创建 活动 对 话 框 中 输入 必要 的 描述 (描述 要 素 一 般 包 含 修改 人 、 修 改 时 
间 和 修改 内 容 等 ) ， 便 于 后 期 的 监控 管理 和 维护 ， 如 图 9-76 所 示 。 


[x Wew Activity 


9-76 输入 活动 信息 


18) 完成 活动 创建 后 ， 右 击 活动 进行 检 入 ， 并 对 DTR 中 开发 对 象 进行 同步 更 新 ， 如 图 9-77 
所 示 。 
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19) 检 和 后， 选择 自动 激活 ， 同 时 生成 一 个 新 的 激活 请 求 ， 在 激活 请 求 视 图 可 以 查看 
具体 的 激活 状态 ， 如 图 9-78 所 示 。 


Use as Default 


Mil Activation Requests £3 > [)")Cheat Sheets| C Prope 
Activation Requests ~ MPD_BPMD_D 
Request ID 


Revert 


Revert Unchanged Items 
% Delete 


7 四 
t Upload 


Forced Upload 
4 Download 
Forced Download 


Properties 


图 9-77 WEZA KAE 图 9-78 查看 激活 请 求 视 图 


20) 请 求 包含 的 活动 中 新 增 了 上 一 次 未 激活 的 活动 ， 每 次 激活 前 都 会 按时 间 顺 序 检测 
CBS 之 前 是 否 有 未 激活 的 活动 ， 可 以 方便 进行 一 并 提交 ， 得 免 出 现 与 DTR 服务 器 端 不 同步 
的 现象 ， 如 图 9-79 所 示 。 

21) 切换 到 传输 管理 视图 ， 两 个 工作 空间 下 已 激活 活动 目录 中 均 出 现 了 待 释放 的 活动 ， 
但 分 别 对 应 的 是 两 位 开发 人 员 各 自修 改 的 内 容 。 使 用 第 一 个 开发 人 员 的 账号 登录 的 工作 空间 
查看 的 是 第 一 次 创建 Web Dynpro 项 目 时 的 活动 ， 如 图 9-80 所 示 。 


D Request Activities Es Activation Results | 


ERÉ en. com_BPMS_1 大 aos 
(eg [dev_zhaox] modify view by rhaox at datel509 E on A a ea 
Ad modify O2View by zhaox at Datel157---add event source code E @. /BPHD/cn. com_BPHS/dev/ active, 


EM modify view by zhaox at datel509 


图 9-79 查看 请 求 包含 的 内 容 图 9-80 第 一 个 开发 人 员 查 看 的 活动 

22) 而 使 用 第 二 个 开发 人 员 的 账号 登录 后 ， 只 能 看 到 他 本 人 修改 产生 的 活动 内 容 。 

23) 活动 的 释放 与 CBS 激活 的 原则 保持 一 致 ， 最 新 的 活动 释放 时 会 优先 释放 之 前 的 活 
动 ， 如 图 9-82 所 示 。 


[Ss Release for Transport 


=l0 x| 


Change request caption: [modify O2View by zhaox at Datel157---add even 


Ee Selected Activities 
À modify O2View by zhaox at Datel157---add event soureé code 
-A Predecessor Activities P 
AÀ modify view by zhaox at datel509 (dev_zhaox) 


Activity Details — = 


Description: 


日 ”项 /BPMD/en. com_BPNS/dev/active/ 
Gi AP Waiting 
a a 过 


dify O2View by zhaox 


图 9-81 第 二 个 开发 人 员 查 看 的 活动 图 9-82 ”查看 释放 涉及 的 活动 内 容 

24) 在 释放 后 ,使 用 第 一 个 开发 人 员 的 账号 登录 工作 空间 ， 并 且 编 辑 同 一 个 视图 ， 将 
会 有 错误 消息 提醒 ， 提 示 文 件 不 能 被 检 出 。 这 是 因为 本 地 的 代码 没有 与 服务 端 同步 ， 之 前 使 
用 了 第 二 个 开发 人 员 的 账号 对 同一 个 视图 进行 了 修改 并 进行 了 检 入 ， 如 图 9-83 所 示 。 
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[Checkout Required xi 


Check-out not possible. 


See below for details. 


The operation requires the following objects to be writeable: 


com. myproject. pjct. base. my02_wd. wd. comp. my02comp. My02CompVi ew 

=> Problem: Not synced to latest D:\n730 wk_t. jdili\DCs\myproject. com\pjct\base\my02_wd\_comp\src\packages\com\myproject 
t\base\my02_ wd\wd\.comp \myO2comp \My02C ompVi ew. wdvi ew. xlf 
==> Problem: Not synced to latest D:\nT30_wk_t. jdi\i\DCs\myproject. comipjct\base\my02_wd\_comp\src\packages\com\myproject 
t\base\my02_, wd\wd\.comp \my02comp \My02C ompVi ew. » wdcontroller 
=====> Problem: Not synced to latest D:\n?30_wk_t. jdi\1\DCs\myproject. com\pjct \base\my02_wd\_comp\src\packages\com\myproject. 
\pjct\base\my02_wd\wd\.comp \my02comp \My02CompYi ew. wdvi ew 


Vi 
q 
q 


iz 


Cancel 


图 9-83 ”错误 消息 提醒 


25) 作为 第 一 位 开发 人 员 ， 首 先 需 要 做 的 是 同步 源 代码 文件 ， 将 本 地 的 开发 对 象 与 
DTR 中 最 新 版 本 进行 同步 ， 如 图 9-84 所 示 。 
26) 右键 对 应 的 目录 ， 选 择 “team” 一 “sync” 进 行 同步 操作 ， 如 图 9-85 所 示 。 

27) 同步 完毕 后 ， 在 文件 目录 中 的 “警告 ”标识 的 感叹 号 消失 了 ， 如 图 9-86 所 示 。 


MyO02Comp. wdcomponent 

MyO02Comp. wdcontroller 

My02CompInter face. wdeontroller 
My02CompInterface. wdlocalcompintfdef 
My02CompInterfaceView. wdeontroller 
My02CompInterfaceView. wdinterfaceview 
i MyO2CompMessagePool. wdmessagepool 

Bh MyO2CompView. wdeontroller 

Bh My02CompVi ew. wdvi ew == Remove from Client 
Pi, MyO2CompVi ew. wdview. xlf 


Show In 


Advanced Sync 


x $ Delete 
司 MyO2Compitindow. wdcontroller Add > - 
时 My02Compřindow. wdnavi gation ; |] My02CompView. wdcontroller 
Edit Li |=) MyO2CompView. wdview 
BD MyO2XompView. wdview. xlf 


MyO2CompWindow. wdwindow 


Locking 


N 


9-84 ”提醒 不 同步 的 开发 对 象 图 9-85 同步 操作 的 菜单 选择 图 9-86 同步 后 的 开发 对 象 
28) 此 时 查看 Web Dynpro 项 目的 视图 控制 器 ， 代 码 未 更 新 ， 如 图 9-87 所 示 。 


public void 
{ 


(com. sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 


//@@begin onActionQuery (ServerEvent) 
//@@end 
} 


图 9-87 查看 同步 后 的 代码 


29) 这 是 由 于 同步 至 本 地 后 ， 还 未 更 新 至 NWDS 开发 工具 中 。 右 击 Web Dynpro MH, 
并 选择 “Reload”， 从 本 地 文件 目录 重新 读 取 开 发 对 象 ， 如 图 9-88 所 示 。 


New » 


Open Component Modeler 
i Rebuild traint 


M Delete Delete 
Check Project Archive Versions 
Deploy 


图 9-88 重 装 项 目的 菜单 选择 


Th 


30) 重新 载 人 后 ， 即 可 看 到 最 新 修改 后 的 源 代 码 ， 如 图 9-89 所 示 。 

注 : 采用 任何 方式 进行 DTR 代码 同步 后 ， 需 要 在 本 地 开发 工具 中 对 项 目 进行 “Reload” 
操作 ， 防 止 因 未 加 载 更 新 代码 而 带 来 修改 的 冲突 。 
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public void onActionQuery (com. sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 
{ 
//@@begin onActionQuery (ServerEvent) 
wdComponentAPI .getMessageManager () .reportSuccess ("执行 成 功 1"); 
//@@end 
| 


图 9-89 查看 重 装 后 的 代码 
9.3.5 代码 冲突 


在 实际 的 项 目 开发 中 ， 多 个 开发 人 员 协 同 开 发 确实 能 够 提升 项 目的 开发 效率 ， 但 在 不 同 
开发 人 员 对 同一 个 DC 进行 修改 时 ， 往 往 会 因为 对 相同 版 本 的 开发 对 象 检 出 并 修改 而 产生 代 
码 冲 突 。 下 面 通过 实例 解析 处 理 版 本 冲突 的 方式 。 

开发 实例 : 

1) 继续 以 上 一 节 中 创建 的 Web Dynpro 项 目 为 例 ， 再 次 编辑 视图 时 ， 首 先进 行 检 出 动 
作 ， 如 图 9-90 所 示 。 


[Checkout Required p zi 


© Whe operation requires the following objects to be writeable: 


View com. myproject. pjct. base. my02_wd. wd. comp. myO2comp. My02Com, 

Read-only: D:\n730_wk_t. jdi\1\DCs\myproject. Fe i, wd\_comp\srec\packages \com\myproject \pjct\base\my02_wdiwd\comp 
\myO2comp \MyO2C ompVi ew. wdvi ew. xl £ 

Read-only: D:\n?30_wk_t. jdi\i\DCs\myproject. comipjct\base\my02_wd\_comp\sre\packages \com\myproject \pjct base \my02_wdiwdicomp 
oci noran ew. wdcontroller 

Read-only: D:\nT30_wk_t. jdi \1\DCs\nyproject. com\pjct\base\my02_wd\_comp\src\packages\com\myproject\pjct \base\my02_wd\wdicomp 
Co waview 


z 


Check Out Cancel 


K 9-90 $h XTE 
2) 检 出 后 ， 将 新 修改 的 内 容 放 和 人 一 个 新 的 活动 中 ， 如 图 9-91 所 示 。 
EX xi 


Display Name [nodi fy O2View by zhaox at Date1553---add source code of event handler 


Description [modify O2View by zhaox at DatelS53---add source code of event handler| 


器 


9-91 创建 活动 


3) 接着 修改 按钮 的 实现 方法 ， 添 加 下 列 代码 ， 作 为 第 一 名 开发 人 员 的 修改 记录 : 


publicvoid onActionQuery (com. sap. tc. webdynpro. progmodel. api. IWDCustomEvent wdEvent) 
| 

//@ @ begin onActionQuery ( ServerEvent) 
wdComponentAPI. getMessageManager( ). reportSuccess( "执行 成 功 1" ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess(" 本 账户 的 修改 1" ) ; 

//@ @ end 

| 
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4) 使 用 第 二 名 开发 人 员 的 账号 登录 NWDI， 并 使 用 新 的 开发 工具 的 工作 空间 进行 修改 ， 
在 检 出 时 NWDI 首先 会 弹出 确认 框 提示 该 文件 已 经 被 其 他 用 户 检 出 并 在 修改 。 在 实际 开发 过 
程 中 ,需要 特别 关注 这 个 提醒 消息 ， 并 及 时 与 组 内 其 他 开发 人 员 进 行 沟通 ,以便 顺利 进行 后 
续 工 作 。 在 本 实例 中 ， 为 了 测试 代码 冲突 ， 仍然 单 击 “OK” 按 钮 ， 继 续 检 出 ， 如 图 9-92 
所 示 。 


© Checking out files that are checked out by other users may cause Severe 
oblems. 


pr 
Do you want to proceed? 


图 9-92 ”代码 冲突 确认 对 话 杠 


5) 同样 地 ,创建 一 个 动作 ， 用 于 包含 第 二 名 开发 人 员 对 开发 对 象 所 做 的 修改 ， 如 图 9-93 
所 示 。 


code event handler 


unt) at Datel648---add souce 


Display Name [modify O2view by zhaox (another acco: 


on [modify O2view by zhaox (another account) at Datel648---add souce code event handler| 


R| 9-93 ”创建 动作 


6) 接着 修改 按钮 的 实现 方法 ， 添 加 下 列 代 码 ， 作 为 第 二 名 开发 人 员 的 修改 记录 : 


publicvoid onActionQuery( com. sap. tc. webdynpro. progmodel. api. IWDCustomEvent wdEvent) 


| 
//@ @ begin onActionQuery( ServerEvent) 
wdComponentAPI. getMessageManager( ). reportSuccess( "执行 成 功 1" ) ; 
wdComponentAPI. getMessageManager( ). reportSuccess(" 其 他 账号 的 修改 1" ) ; 
//@ @ end 
| 


7) 此 时 ， 两 名 开发 人 员 都 已 对 同一 个 开发 对 象 进 行 了 修改 ， 任 何人 进行 “Checkin” 
的 检 入 操作 都 会 失败 ， 如 图 9-94 所 示 。 


Could not check in activity due to version conflicts. Resolve the conflicts 
| and try again. 


图 9-94 ”报错 对 话 框 


8) Æ DTR 视图 中 可 以 看 到 文件 已 标记 为 红色 ， 表 示 已 有 代码 冲突 产生 ， 如 图 9-59 所 示 。 
9) 如 果 右 击 这 些 源 代 码 文件 ， 并 查看 版 本 图 像 ， 则 可 以 看 到 最 新 修改 中 产生 了 两 个 同 
样 的 版 本 ， 如 图 9-9%6 所 示 。 
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ZO My02CompView. wdeontroller Pei, 
Za) MyO2CompView. wdvi ew AA p 
SA or 


SD My02CompView. wdview. xl£ 


图 9-95 产生 冲突 的 开发 对 象 图 9-96 查看 DTR 版 本 记录 


10) 正 因为 两 个 版 本 的 存在 ， 所 以 导致 第 三 名 开发 人 员 在 检 入 活动 时 失败 。 比 较 简 单 
的 两 种 处 理 方式 : 一 种 方法 是 强制 接受 本 地 修改 ， 履 盖 服 务 器 端 代码 ; 另 一 种 方法 是 接受 服 
务 端的 版 本 ,覆盖 本 地 代码 ， 并 做 再 次 修改 提交 。 如 果 比 较 熟 悉 处 理 代 码 冲 突 ， 还 可 以 使 用 
“Merge” 功 能 ， 手 动 将 两 个 版 本 代码 进行 合并 。 这 里 使 用 第 二 种 方法 ， 首 先 重新 从 服务 带 
端 同 步 源 代码 文件 ， 右 击 活动 中 产生 冲突 的 开发 对 象 ， 选 择 “ Resolve Conflict” — “Accept 
Active (Remote) Version”， 如 图 9-97 所 示 。 


[RR /BPMD/cn. com_BPNS/ dev/inactivef 
El AX modify O2view by zhaox (another account) at DatelB48---add souce 


“Er C ojec acka; 
“Er Show In lm 
VEP .../DCsfmyproject 4 Synce 
Advanced Sync 上 
ea Remove from Client 
th Add 
A Edit 
Edit (Exclusive) 
$ Delete 


Locking 上 


Revert 
Resolve Conflict CAF Resolve 
Merge 


GS View Content 
A View Changes 


Compare with Active Version 


Auto Merge 


Merge with 


Move into Activity... 


Accept Your (Local) Ver: 


FA 9-97 处 理 冲 突 的 菜单 选择 


11) 弹出 的 对 话 框 确认 是 否 接受 覆盖 本 地 代码 的 操作 ， 单 击 “Accept Active Version” 
按钮 ， 如 图 9-98 所 示 。 


[Accept Active (Remote) Version (s) x! 


This action will result in the loss of your local changes. Do you really 
i want to accept the active (remote) version(s)? 


Accept Active Version Cancel 


9-98 确认 版 本 的 对 话 


IHI 


12) 在 将 所 有 文件 覆盖 后 ， 记 得 将 项 目 进行 “Reload” 重 新 载 和 最 新 版 本 的 代码 ， 接 着 
进入 视图 控制 器 ， 就 可 以 看 到 第 一 名 开发 人 员 已 经 添加 的 代码 ， 如 图 9-99 所 示 。 


public void onActionQuery (com.sap.tc.webdynpro.progmodel.api.IWDCustomEvent wdEvent ) 
{ 


//@@begin onActionQuery (ServerEvent) 
wdComponentAPI.getMessageManager () .reportSuccess (" 执 行 成 功 !") > 
wdComponentAPI .getMessageManager () .reportSuccess (" 本 账户 的 修改 !") + 

//@@end 


} 


图 9-99 查看 重 装 后 的 代码 
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注 : 在 团队 开发 过 程 中 ， 不 论 使 用 哪 种 方法 处 理 代码 冲突 ， 一 定 要 提前 与 其 他 开发 人 员 
或 开发 组 长 进行 沟通 ， 团 队 协 作 不 仅 依赖 于 系统 提供 的 检 入 、 检 出 、 罕 盖 等 功能 ， 还 依赖 于 
团队 成 员 的 良好 沟通 机 制 。 


9.4 开发 组 件 的 依赖 


在 之 前 Web Dynpro 的 章节 中 ， 介 绍 了 Web Dynpro 的 对 外 可 见 部 分 仅 有 它 的 接口 视图 和 
接口 控制 锅 ， 通 过 它们 可 以 将 不 同 的 Web Dynpro 项 目 串 联 在 一 起 ; 而 在 SAP NetWeaver 平 
台 的 开发 中 ， 每 一 个 开发 组 件 的 对 外 可 见 部 分 是 它 的 公共 部 分 ， 对 于 不 同类 型 的 项 目 依赖 和 
关联 ， 都 是 通过 公共 部 分 来 进行 串联 。 

例如 ， 在 第 7 章 中 ,在 将 BPM 项 目 与 Web Dynpro 项 目 进 行 关联 之 前 ， 首 先 需要 在 Web 
Dynpro 中 定义 公共 部 分 ， 并 将 需要 公布 的 组 件 添加 至 其 中 ， 配 置 完 成 后 ， 在 BPM 的 业务 流 
程 和 任务 配置 中 才能 找到 对 应 的 Web Dynpro 的 接口 视图 和 流转 触发 事件 。 

9.4.1 公共 部 分 与 依赖 明细 
在 NWDI 中 ， 所 有 开发 组 件 都 可 以 定义 两 种 类 型 的 公共 部 分 ， 如 图 9-100 所 示 。 
e Compilation， 设 计时 使 用 ， 主 要 为 其 他 DC 在 开发 时 提供 API， 其 他 DC 使 用 此 DC 的 
类 及 方法 时 ， 需 要 依赖 于 本 DC 的 公共 部 分 。 
© Assembly; 运行 时 使 用 ， 本 身 不 能 独立 部 署 运行 ， 需 要 打包 到 其 他 DC 时 建立 此 种 类 
型 公共 部 分 ， 其 中 应 包含 接口 及 其 实现 ， 并 保证 其 功能 运行 正常 。 

而 在 DI 透视 图 中 ， 选 中 任意 一 个 公共 部 分 后 ， 还 需要 配置 具体 的 开发 组 件 依 赖 明 细 
(Dependency Details) ， 它 包含 了 以 下 4 种 方式 ( 见 图 9-101 ) : 

© Design Time: 用 于 此 DC 在 开发 设计 时 ， 某 些 插件 对 于 其 他 DC 组 件 基于 此 种 类 型 的 

依赖 关系 进行 引用 。 

è Build Time; 用 于 此 DC 在 编译 时 ， 需 要 其 他 DC 的 类 及 组 件 时 ， 建 立 此 种 类 型 依赖 

关系 。 

è Deploy Time; 用 于 此 DC 引用 其 他 DC 的 类 及 组 件 ， 并 且 需 要 约束 在 此 DC 部 署 时 ， 

依赖 的 DC 必须 已 经 部 署 ， 建 立 此 种 类 型 依赖 关系 。 

è Runtime; 用 于 此 DC 在 运行 时 需要 引用 其 他 DC 的 类 及 组 件 时 ， 建 立 此 种 类 型 依赖 

关系 。 


pendency Details 
Define the properties of the selected dependency 


Defined Public Parts M| Design Time 
Specify the list of public parts for this DC F] Deploy Time 
> Æ client 
> E ejbjar E| Runtime strong + 
图 9-100 公共 部 分 的 两 种 类 型 图 9-101 依赖 明细 


E: 如 果 所 依赖 的 DC 没有 部 署 至 服务 器 ， 当 前 DC 可 以 部 署 但 无 法 正确 运行 ， 只 有 所 
有 依赖 的 DC 成 功 部 署 后 ， 当 前 DC 才 可 以 正常 运行 
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9.4.2 ”依赖 规则 参考 


开发 中 经 常 涉及 DC 之 间 的 依赖 使 用 ，DC 之 间 的 依赖 需要 遵守 固定 的 规则 ， 以 防止 因 
依赖 问题 而 导致 的 运行 时 错误 或 异常 。 

除了 WD4J 的 项 目 以 外 ， 任 何 包含 “Compilation” 与 “Assembly” 类 型 的 公共 部 分 的 开 
发 组 件 (DC) 在 被 其 他 开发 组 件 依 赖 时 都 仅 有 一 次 对 编译 时 (Build Time) 的 选中 , “Com- 
pilation” 类 型 公共 部 分 确保 编译 时 能 够 正常 ， 而 “Assembly” 类 型 公共 部 分 是 运行 时 被 使 
用 ， 任 何 一 个 错误 的 依赖 都 会 导致 设计 时 或 运行 时 的 失败 ， 而 通过 对 编译 时 的 重复 限制 会 避 
免 因 多 处 编译 而 导致 重复 的 类 加 载 异 常 。 下 面 将 以 表 的 方式 展现 不 同 项 目 类 型 中 的 公共 部 分 
的 定义 名 称 和 包含 实体 ， 在 表 中 通过 “X” 表 示 勾 选 对 应 的 依赖 关系 ， 留 空 则 为 不 勾 选 依 赖 
关系 。 

1. EJB 项 目 

EJB 公共 部 分 定义 参考 ( 见 图 9-102) 见 表 9-3。 


表 9-3 EJB 公共 部 分 定义 参考 


类 型 名 称 包含 实体 
Compilation client 项 目的 接口 (interface) 和 工厂 类 ( factory class) 
Assembly ejbjar 相关 JAR 文件 ， 即 ejb- jar 


Defined Public Parts 
Specify the list of public parts for this DC 


图 9-102 ”公共 部 分 定义 


EAR 项 目 对 于 EJB 的 依赖 配置 参考 ( 见 图 9-103) 见 表 9-4。 
表 9-4 EAR 项 目 对 于 EJB 的 依赖 参考 


Build Time Design Time Deploy Time Runtime 


EJB 项 目 


ejbjar X 


client 


Required DCs Dependency Details 

Specify the list of DCs required for this DC Define the properties of the selected dependency 
4 | Be myejb01| 

(eB ejbjar 


E] Deploy Time 


E dient F] Runtime 


DE 
Add... 


Resolve All 


图 9-103 依赖 配置 


WD4J 项 目 对 于 EJB 的 依赖 配置 参考 (ILK 9-104) 见 表 9-5, 
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表 9-5 WDA 项 目 对 于 EJB 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
EJB 项 目 
ejbjar 
client X 


WD4J 项 目 对 于 EAR 的 依赖 配置 参考 ( 见 图 9-105) 见 表 9-6。 
表 9-6 WD4J 项 目 对 于 EAR 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
EAR 项 目 X 


2. LIB 项 目 
LIB 公共 部 分 定义 参考 ( 见 图 9-106) 见 表 9-7。 


表 9-7 LTB 公共 部 分 定义 参考 


类 型 名 称 包含 实体 
Compilation api 项 目 包 含 的 JAR 文件 
Assembly archives 项 目 包含 的 JAR 文件 


Dependency Details 
Define the properties of the selected dependency 


F] Design Time Defined Public Parts 
Specify the list of public parts for this DC 
F] Deploy Time a onl 
= a sapjco3jar 
a| Tø myejb01 | 7| Runtime strong + a & archives 
E client ý sapjco3jar 
E ejbjar 
z ery 
图 9-104 依赖 配置 图 9-105 依赖 明细 图 9-106 公共 部 分 定义 


EAR 项 目 对 于 LIB 的 依赖 配置 参考 ( 见 图 9-107) 见 表 9-8。 
表 9-8 EAR MEX F LIB 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
EJB 项 目 
archives X 
api 
Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the selected dependency| 
+ | Ba mylibor HE Deploy Time 
@ archives 
@ api Add... Runtime 
Remove 


图 9-107 依赖 明细 


WD4J 项 目 对 于 LIB 的 依赖 配置 参考 ( 见 图 9-108) 见 表 9-9。 
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9-9 WD4J 项 目 对 于 LIB 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
EJB 项 目 
archives 
api X 


WD4J 项 目 对 于 EAR 的 依赖 配置 参考 (ILE 9-109) LÆ 9-10, 
R 9-10 WD4J 项 目 对 于 EAR 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 


EAR JHA X 


Dependency Details 


Define the properties of the selected dependency 


Design Time 


a 


回 


Deploy Time 


图 


Runtime strong + 


图 9-108 依赖 配置 图 9-109 依赖 明细 


3. Java 项 目 
Java 项 日 公共 部 分 定义 参考 〈 见 图 9-110) 见 表 9-11。 


表 9-11 Java 项 目 公 共 部 分 定义 参考 


类 型 名 称 包含 实体 
Compilation api 项 目的 接口 (interface) 和 工厂 类 ( factory class) 
Assembly archives 项 目的 接口 (interface) 和 工厂 类 ( factory class) 


EAR 项 目 对 于 Java 的 依赖 配置 参考 ( 见 图 9-111) 见 表 9-12。 
表 9-12 EAR 项 目 对 于 Java 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
EJB 项目 
archives X 
api 


Required DCs 


Defined Public Parts Specify the list of DCs required for this DC 
Specify the list of public parts for this DC 4 | Dee myjav04 
(§ api (archives 
车 archives ( api 
图 9-110 公共 部 分 定义 图 9-111 依赖 配置 


WD4J 项 目 对 于 Java 的 依赖 配置 参考 ( 见 图 9-112) 见 表 9-13。 
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Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the selected dependency 
Ga myear07 eS) ] Design Time 
4 | Dee myjav04 
E api Add... Deploy Time 
arene f Bemas Runtime strong + 
图 9-112 依赖 明细 
表 9-13 WD4J 项 目 对 于 Java 的 依赖 配置 参考 
Build Time Design Time Deploy Time Runtime 
EJB 项 目 
archives 
api X 
WD4J 项 目 对 于 EAR 的 依赖 配置 参考 ( 见 图 9-113) 见 表 9-14。 
Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the selected dependency 
Sin myear07 日 日 Design Time 
Det myjav04 
Da tc/aii/base/offline/facade E] Deploy Time 
Da tc/bl/exception/lib | . 
Ta tc/bl/logging/api W] Runtime strong + 
图 9-113 依赖 明细 
表 9-14 WD4J 项 目 对 于 EAR 的 依赖 配置 参考 
Build Time Design Time Deploy Time Runtime 


EAR 项 目 X 


4. EAR 项 目 之 间 
EAR 项 日 对 于 EAR 的 依赖 配置 参考 ( 见 图 9-114) 见 表 9-15。 


Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the selected dependency 
Dee myear07 


> *D myejb01 


四 E | 
Runtime 


图 9-114 依赖 明细 
表 9-15 EAR 项 目 对 于 EAR 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 


EAR 项 目 X 


5. WD4J 项 目 
WD4J 项 目 公共 部 分 定义 参考 ( 见 图 9-115) 见 表 9-16。 


Defined Public Parts 
Specify the list of public parts for this DC 


3 Dynp01Comp 


> 


Ea 
$ 
alg 
x 


图 9-115 
410 


9-16 WD4J 项 目 公 共 部 分 定义 参考 


类 型 名 称 包含 实体 
Compilation api 项 目 中 的 组 件 


BPM 项 目 对 于 WD4J 的 依赖 配置 参考 ( 见 图 9-116) 见 表 9-17。 


Required DCs 
Specify the list of DCs required for this DC 
Ba bie/sca/scdl/contributors/glx 


E] Design Time 
Ba bie/sca/scdl/contributors/mc 
Da bie/sca/scdl/gen Add... Deploy Time 
Da bie/sca/scdl/gen/mc 
Be bie/sca/scdl/gen/xlf2prop 
Bq ide/es/config/mc/model/bi Resolve All 
* D4 mydynp0s 
Ef api 


TRS] 


Dependency Details 
Define the properties of the selected dependency 


图 9-116 依赖 明细 


$ 9-17 BPM 项 目 对 于 WD4J 的 依赖 配置 参考 


Build Time Design Time Deploy Time Runtime 
WD4J 项 目 X 
api X 
WD4J 项 目 对 于 WD4J 的 依赖 配置 参考 (ILE 9-117) ILK 9-18, 
Required DCs Dependency Details 
Specify the list of DCs required for this DC Define the properties of the selected dependency 
4 (Gamo 由 日 E| Design Time 
E api = 
Da tc/aii/base/offline/facade E| Deploy Time 
Da tc/bl/exception/lib = . 
Bq tc/bl/logging/api [V] Runtime strong + 
Da tc/cmi 
Da tc/ddic/runtime/facade 
Da tc/wd/api 
图 9-117 依赖 明细 
表 9-18 WD4J 项 目 对 于 WD4J 的 依赖 配置 参考 
Build Time Design Time Deploy Time Runtime 
WD4J 项 目 X 
api X 
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